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Preface 



This publication is intended to help you 
use the debugging facilities provided with 
the IBM System/ 360 Operating System. It 
describes, in assembler language terms, the 
major debugging facilities provided with 
the System/360 Operating System, and is 
directed towards the programmer who deals 
with system and application program 
problems . 



The publication is divided into three 
principal parts: "Section 1: Operating 
System Concepts;" "Section 2: Interpreting 
Dumps; " and "Section 3: Tracing Aids," 
plus an Introduction and a set of 
Appendixes that provide specific debugging 
information. 



The Introduction provides a brief survey 
of the material presented in the balance of 
the publication. 



Section 1 deals with internal aspects of 
the operating system that are pertinent to 
debugging. A working knowledge of this 
information will provide you with the means 
of determining the status of the system at 
the time of failure, and the course of 
events which led up to that failure. The 
general precedure for debugging with an 
operating system dump (Appendix A) assumes 
knowledge of this control flow. 



Section 2 includes instructions for 
invoking, reading, and interpreting storage 
dumps of systems with MFT or MVT control 
programs. The material is intended to aid 
you in interpreting dumps and isolating 
errors. 

Section 3 deals with the save area 
chain, the Trace Option, and the 
Generalized Trace Facility. Output from 
the Generalized Trace Facility is 
discussed. 

Before reading this publication, you 
should have a general knowledge of 
operating system features and concepts as 
presented in the prerequisite publications. 
Occasionally, the text refers you to other 
publications for detailed discussions 
beyond the scope of this book. 



For information on debugging facilities 
provided within higher languages, consult 
the programmers' guides associated with the 
respective languages. Other System/ 3 60 
Operating System publications, such as 
Messages and Codes , describe additional 
debugging aids provided for the assembler 
language programmer. 

Notice : Coding level information presented 
in this publication must not be used for 
coding purposes or exposure to changes in 
implementation may result. The information 
is presented for debugging purposes only. 
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Summary of Amendments 



Summary of Amendments 
for GC28-6670-5.-6 
as Updated by GN28-2545 
OS Release 21.7 

Model 91 or 195 Imprecise Interruption 
An explanation of the bits set by an 
imprecise interruption on the Model 91 
or 195 has been added. 

AMDPRDMP Format Changes 

Some additional fields have been added 
to the JOB information and the TCB. 

AMDPRDMP Messages 

Several new messages can be put out by 
AMDPRDMP to aid in debugging. 

GTF Records 

The DSP, EXT, PRM, and SVC 
comprehensive trace records have had a 
parameter added to the MODN field. 



The explanation for SVC 79 (STATUS) has 
been changed. 



New Emulator 



The 707*» emulator can be run on the 
Model 155. 

New I/O Devices 

Sense byte information has been added 
for the 3213, 3215, 3272, 3277, and 
3333 as well as additional support for 
the 3410/3411. 

Miscellaneous Corrections 

Several additional changes have been 
made to correct errors. 



Summary of Amendments 
for GC28-6670-5 
OS Release 21 



PCP REMOVAL 

References to the PCP version of 
Operating System/360 have been deleted 
from the publication. 

TESTRAN REMOVAL 

References to the TESTRAN testing 
facility of Operating System/360 have 
been deleted from the publication. 

IMDPRDMP SERVICE AID OUTPUT 

Storage dumps as formatted and 
displayed by the IMDPRDMP service aid 
are now discussed in this publication. 
This material was formerly in the 
Service Aids publication, GC28-6719. 

GENERALIZED TRACE FACILITY (GTF) OUTPUT 

GTF trace records, as processed by the 
EDIT function of the IMDPRDMP service 
aid are illustrated and discussed in 
Section 3 of the publication. 

DEVICE SUPPORT 

The sense byte information given in 
Appendix G is updated to include 
information for the: 

IBM 3420 Magnetic Tape Unit and 3803 
Tape Control 



IBM 2596 Card Read Punch 

IBM 3505 Card Reader 

IBM 3525 Card Punch 

IBM 3410 Magnetic Tape Unit 

IBM 3411 Magnetic Tape Unit and 

Control 



PROBLEM DETERMINATION 

Addition of an Appendix discussing 
problem determination aids for 
OPEN/CLOSE/EOV processing. 



Updating of the completion codes and 
service aids Appendixes to reflect 
release 21 changes. - 



The Console Dump facility, used to 
obtain a storage dump for later 
processing by IMDPRDMP, is briefly 
described in the storage dump and 
IMDPRDMP formatting section of the 
publication. 

MISCELLANEOUS 

Editorial improvements and corrections 
to existing material have been made 
throughout the publication. 
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Summary of Amendments 

for GC28-6670-4 

as Updated by GN28-2457 and GN28-2472 

OS Release 20.1 



TCAM 3330. 2305. 2319 

Section 2: ABEND/ SNAP Dump (PCP and MFT) Appendix F 

ABEND/SNAP Dump (MVT) Additional of sense byte information fo 

Appendix A new devices. 

Appendix H 

A brief description of TCAM debugging 

Aids and a new SVC. 

TSO MISCELLANEOUS 

Section 2: TSO Control Blocks Appendix C 

Appendix A 1. Addition of module name prefixes 

The addition of new SVCs and a summary for emulator programs, 
of the control blocks formatted by 

IMDPRDMP . Appendix G 

2. New features of service aid program 
IMAPTFLE. 



Summary of Amendments 
for GC28-6670-3 
OS Release 20 



IMDPRDMP TSO 



"Guide to Using a Storage Image Dump" Appendix A 

IMDPRDMP is used instead of IEAPRINT to New SVCs in Appendix A. This 
print MFT and MVT dumps. information is for planning purposes 

only. 
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Introduction 



To debug efficiently, you should be 
familiar with the system control 
information reflected in dumps. This 
control information, in the form of control 
blocks and traces, tells you what has 
happened up to the point of error and where 
key information related to the program is 
located. To provide an insight into the 
IBM System/36,0 Operating System and its 
complex aspects of task management and 
storage supervision. Section 1 of this 
publication provides an orientation in the 
control functions of the operating system. 

The IBM System/ 360 Opera tii.g System 
provides extensive debugging facilities to 
aid you in locating errors and determining 
the system state quickly, some debugging 
aids, such as console messages, provide 
limited information that may not always 
help you identify the error. This manual 
discusses those debugging facilities that 
provide you with the most extensive 
information: 

a. Abnormal termination (ABEND) and 
snapshot (SNAP) dumps. 

b. Indicative dumps. 

c. Storage image dumps. 

d. Tracing facilities. 

Dumps are discussed in Section 2 and 
tracing facilities in Section 3. 

ABEND and SNAP Dumps are invoked by ABEND 
and SNAP macro instructions, respectively. 
They are grouped in a single category 
because they provide identical information. 
In addition to a hexadecimal dump of main 
storage, they can contain conveniently 
edited control information and displays of 
the operating system nucleus and trace 
table. 

Indicative dumps contain control 
information useful in isolating the 
instruction that caused an abnormal end of 
task situation. The information is similar 
to that given in an ABEND/SNAP dump, but 
does not include a dump of main storage. 

Storage dumps are produced by either the 
system dump facility at the time of a 
system failure, or by a dump program 
created through use of the IMDSADMP service 
aid. IMDSADMP programs must be loaded into 



storage through use of the IPL facilities 
and are intended for use in situations in 
which the system is not operative, e.g., a 
disabled wait state or an unending system 
loop. 

The system dump facility writes to the 
SYS1.DUMP data set. The IMDPRDMP service 
aid is used to format and print the 
SYSl.DUMP data set. IMDPRDMP output is 
described in this publication. The 
IMDSADMP programs write to tape (high-speed 
dump) or to tape or printer (low- speed 
dump). The output tape produced by the 
high-speed dump must be processed by the 
IMDPRDMP program; low-speed output to tape 
may be processed by IMDPRDMP, IEBPTPCH or 
the IEBGENER utility program. 

Storage dumps taken by the system dump 
facility consist of control information 
followed by a display of printable storage 
from location 00 to the capacity of 
storage. Storage words are displayed in 
both hexadecimal and EBCDIC notation. 
Storage dumps taken by an IMDSADMP program 
consist of register contents followed by a 
display of storage from location 00 to the 
capacity of storage. Notation is in both 
hexadecimal and EBCDIC. 

Tracing facilities consist of the save 
area chain trace, the Trace Option and the 
Generalized Trace Facility. 

The save area chain enables tracing of 
the save areas for each level of load 
module in a task. The save area trace is 
displayed in ABEND/SNAP and storage dumps. 

The Trace Option, if installed in the 
system, provides records of system 
interruptions (IO, SIO, etc.) that are 
displayed in ABEND/SNAP and storage dumps. 

The Generalized Trace Facility (GTF) 
enables selective tracing of system and 
application program events and records the 
information internally, in a table which is 
displayed in printouts of ABEND dumps and 
storage dumps, or externally in a data set 
which is processed by the IMDPRDMP service 
aid to provide edited and formatted GTF 
trace records. (For complete information 
on GTF see the Service Aids publication.) 
The GTF output, as processed by IMDPRDMP, 
is discussed in Section 3 of this 
publication. 
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General Notes : • Control block field names referred to 

are those used in the IBM System/ 3 60 

• Displacements and addresses shown in Operating System: System Control 

the text and illustrations of this Blocks manual, GC28-6628. 
publication are given in decimal 

numbers, followed by the corresponding • Wherever possible, diagrams, and 

hexadecimal number in parentheses, reproductions of dumps have been 

e.g., TCB+ 14(E); location 28(1C); SVC included to aid you during the 

42 (2A). All other numbers in the text debugging process, 
are decimal, e.g., the seventeenth word 
of the TCB; a jHword control block; 15 
job steps. 
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Section 1: Operating System Concepts 



This section introduces you to the control 
information that you must know to interpret 
dumps. It is divided into three topics: 

• task management 

• main storage supervision 

• system control blocks and tables 

The first two topics deal with those 
aspects of task management and main storage 
management, respectively, that are 
represented in dumps. The third topic 
describes the remaining system control 
blocks and tables helpful in pinpointing 
errors. 

Note : The descriptions of system control 
blocks and tables in this section emphasize 
function rather than byte-by-byte contents. 
Appendix K summarizes the contents of those 
control blocks most useful in debugging. 

For a more detailed description of 
system control blocks and tables, refer to 
the system Control Blocks publication, 
GC28-6628. 



Task Management 



The task management control information 
most useful in debugging with a dump 
includes the task control block and its 
associated request blocks and elements. 
The functions, interactions, and 
relationships to other system features of 
these items are discussed in this topic. 2 
summary of how task supervision differs at 
each system level concludes the topic. 



Task Control Block 

The operating system keeps pointers to all 
information related to a task in a task 
control block (TCB) . For the most part, 
the TCB contains pointers to other system 
control blocks. By using these pointers, 
you can learn such facts as what I/O 
devices were allocated to the task, which 
data sets were open, and which load modules 
were requested. 

Figure 1 shows some of the control 
information that can be located by using 
the pointers in the TCB. Later, in the 
discussion of system control blocks and 
tables. Figure 1 is expanded to show the 
actual block names and pointer addresses. 
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Request Blocks 

Frequently, the routines that comprise a 
task are not all brought into main storage 
with the first load module. Instead, they 
are requested by the task as it requires 
them. This dynamic loading capability 
necessitates another type of control block 
to describe each load module associated 
with a task — a request block (RB). An RB 
is created by the control program when it 
receives a request from the system or from 
a problem program to fetch a load module 
for execution, and at other times, such as 
when a type II supervisor call (SVC) is 
issued. By looking at RBs, you can 
determine which load modules have been 
executed, why each lost control, and, in 
most cases, which one was the source of an 
error condition. 

There are seven types of RBs created by 
the control program: 

• Program request block (PRB) 

• Supervisor request block (SVRB) 

• Interrupt request block (IRB) 
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• Supervisor interrupt request block 
(SIRB) 

. • Loaded program request block (LPRB) 

• Loaded request block (LRB) 

• Finch request block (FRB) 

Of these, you will most often encounter 
the PRB and SVRB in dumps. The type of RB 
created depends on the routine or load 
module with Which it is associated. 

PRB (Systems with MFT) s A PRB is created 
whenever an XCTL, LINK, or ATTACH macro 
instruction is issued. It is located * 
immediately before the load module with 
which it is associated. 



LRB (MFT only) ; The LRB is a shortened 
form of an LPRB. Routines associated with 
LRBs can be invoked only by a LOAD macro 
instruction. This attribute is assigned to 
a routine through the OL (only loadable) 
subparameter in the PARM parameter of the 
EXEC statement that executes the linkage 
editor. The most common reason for 
assigning this attribute is that linkage 
conventions for XCTL, LINK, and ATTACH are 
not followed. This request block is 
located immediately before the load module 
with which it is associated. 



PRB (Systems with MVT) : A PRB is created 
whenever an XCTL or LINK macro instruction 
is issued. It is located in a fixed area 
of the operating system. 

SVRB : An SVRB is created each time a type 
II, III, or IV supervisor call is issued. 
(Type I SVC routines are resident, but run 
disabled; they do not require a request 
block.) This block is used to store 
information if an interruption occurs 
during execution of these SVC routines. A 
list of SVCs, including their numbers and 
types, appears in Appendix A. 

IRB : An IRB is created each time an 
asynchronous exit routine is executed. It 
is associated with an event that can occur 
at an unpredictable time during program 
execution, such as a timing routine 
initiated by an STIMER macro instruction. 
The IRB is filled at the time the event 
occurs, just before control is given to the 
exit routine. 

SIRB : An SIRB is similar to an IRB, except 
that it is associated only with 
IBM-supplied input/output error routines. 
Its associated error rout in e\ is fetched 
from the SYS1.SVCLIB data set. 

LPRB (MFT only) s An LPRB is created when a 
LOAD macro instruction is issued unless the 
LOAD macro instruction specifies: 

• A routine that has already been loaded. 

• A routine that is being loaded in 
response to a LOAD macro instruction 
previously issued by a task in the 
partition (MFT with subtasking). 

• A routine that is "only loadable" (see 
LRB). 

An LPRB is located immediately before the 
load module with which it is associated. 
Routines for which an LPRB is created can 
also be invoked by XCTL, LINK, and ATTACH 
macro instructions . 



FRB (MFT with subtasking only) : An FRB is 
created and attached to the job pack area 
queue, during LOAD macro instruction 
processing, if the requested module is not 
already in the job pack area. The FRB 
describes a module being loaded in response 
to a LOAD macro instruction. Any 
subsequent requests for the same module , 
received while it is still being loaded, 
are deferred by means of wait list elements 
(WLEs) queued to the FRB. When the module 
is fully loaded, an LRB or an LPRB is 
created, the FRB is removed from the job 
pack area queue, and any requests, 
represented by wait list elements, are 
reinitiated. 



Figure 2 shows the relative size of the 
seven types of RBs and the significant 
fields in each. 



In Figure 2, the "size" field tells the 
number of doublewords in both the RB and 
its associated load module. The PSW 
contained in the "resume PSW" field 
reflects the reason that the associated 
load module lost control. Other fields are 
discussed in succeeding topics. 

This far, the characteristics of the TCB 
and its associated RBs have been discussed. 
With the possibility of many RBs 
subordinate to one task, it is necessary 
that queues cf RBs be maintained. In 
systems with MFT without subtasking, two 
queues are maintained by the system — the 
active RB queue and the load list. In MFT 
systems with subtasking, a job pack area 
queue, containing FRBs, and LRBs and LPRBs 
that represent reenterable modules is also 
maintained. MVT systems maintain an active 
RB queue and a contents directory. The 
contents directory is made up of three 
separate queues: the link pack area 
control queue (LPAQ) ; the job pack area 
control queue (JPAQ); and the load list . 



14 Programmer's Guide to Debugging (Release 21.7) 



LPRB 



-12 



Major RB address 
(MFT with subtasking) 



-8 Load list pointers 

(MFT) 

-4 Absent (MVT) 



Module name 

(MFT) 

Last half of user's 

PSW (MVT) 



Size 



»2(C) 
UseCt 



Flags 



A Entry point (MFT); 
A CDE(MVT) 



16 (10) 



Resume PSW 



28 (1C) 
Woit Ct 



Next RB 



SVRB 



Module name 

(MFT) 

Last half of user's 

PSW (MVT) 



Size 



12(C) 
UseCt 



Flags 



4 Entry point (MFT); 
4 CDE (MVT) 



16 (10) 



Resume PSW 



28(1C) 
Wait Ct 



Next RB 



32(20) 



Register 
Save Area 



96 (60) 



Extended 
Save Area 



LRB 






^"t.V'-^,AiJfea^i 



-8 



Load list pointers 
(MFT) 

Absent (MVT) 



Module name 

(MFT) 

Last half of user's 

PSW (MVT) 



Size 



12(C) 
UseCt 



Flags 



f Entry point (MFT); 
A CDE (MVT) 



Program Extent List 



Length of extent in 
I hiearchy 

+ 4 Length of extent In 

' hiearchy 1 



H 



r- 



+ 8 



h 



Address of extent in 
hiearchy 



-I 
I 

+ 12(C) Address of extent in ■ 
hiearchy 1 ■ 



IRB 



Module name 

(MFT) 

Last half of user's 

PSW (MVT) 



Size 



12(C) 
UseCt 



Flags 



♦ Entry point (MFT); 
f CDE (MVT) 



16 (10) 



Resume PSW 



28 (1C) 
WaitCt 



Next RB 



32 (20) 



Register 
Save Area 



! ?' j MfM 



Mi 






PRB 



FRB 





Module name 

(MFT) 

Last half of user's 

PSW (MVT) 



Size 



12(C) 
UseCt 



Flags 



t Entry point (MFT); 
A CDE (MVT) 



16 (10) 



Resume PSW 



28 (1C) 
WaitCt 



Next RB 



Load list 
■4 pointers 



Module name 



Size 



Flags 



12(C) 



Address of WLE 



16 (10) 



Address of TCB 



20 (14) 



Address of LPRB 




Note: Program extent list is added to LPRB, LRB, or PRB If the 
program described was hiearchy block loaded. 
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Figure 2- RB Formats 
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Active RB Queue 

The active RB queue is a chain of request 
blocks associated with active load modules 
and SVC routines. This queue can contain 
PRBs, SVRBs, IRBs, SIRBs, and under certain 
circumstances, LPRBs. Figure 3 illustrates 
how the active RB queue links together the 
TCB and its associated RBs. 




Ta 



tTCB 



RB-A RB-B 

cn 



RB-C 



h 



_D tRB-A 






Ud 



♦c 



fRB-B 



tn 



Load 
modules. 



. . . and 
SVC routines 



Figure 3. Active RB Queue 

The request blocks in the active RB 
queue in Figure 3 represent three load 
modules. Load module A invokes load module 
B, and B, in turn, invokes C. When 
execution of A began, only one RB existed. 
When the first invoking request was 
encountered, a second RB was created, the 
TCB field that points to the most recent RB 
was changed, and A*s status information was 
stored in RB-A. A similar set of actions 
occurred when the second invoking request 
was encountered. As each load module is 
executed and control is returned to the 
next higher level load module, its RB is 
removed from the chain and pointers are 
updated accordingly. 

Load List 

The load list is a chain of request blocks 
or elements associated with load modules 
invoked by a LOAD macro instruction. The 
load list differs from the active RB queue 
in that RBs and associated load modules are 
not deleted automatically. They remain 
intact until they are deleted with a DELETE 
macro instruction or job step termination 
occurs. By looking at the load list, you 
can determine which system and problem 



program routines were loaded before the 
dump was taken. The format of the load 
list differs with control program levels. 

Systems with MFT (without subtaskinq) : At 
this control program level, the load list 
associated with a TCB contains LRBs and 
LPRBs. RBs on the load list are linked 
together somewhat differently from those on 
the active RB queue because of the 
characteristics of the LOAD macro 
instruction. Because RBs may be deleted 
from a load list in a different order than 
they were created (depending on the order 
of DELETE macro instructions), they must 
have both forward and backward pointers. 
Figure 4 illustrates how a load list links 
together a TCB and three RBs. 




Figure 4. Load List (MFT) 

Here, each RB contains a pointer both to 
the previous RB and the next most recent RB 
in the list. If there is no previous or 
more recent RB, these fields contain zeros 
and a pointer to the TCB, respectively. 

Another field of a load list RB that 
merits consideration is the use count. 
Whenever a LOAD macro instruction is 
issued, the load list is searched to see if 
the routine is already loaded. If it is 
loaded, the system increments the use count 
by one and passes the entry point address 
to the requesting routine. 

Each time a DELETE macro instruction is 
issued for the routine, the use count is 
decremented by one. When it reaches zero, 
the RB is removed from the load list and 
storage occupied by the associated routine 
is freed. 
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Systems With MFT (With Subtaskinq) : At 
this control program level, the load list 
is used as described for MFT without 
subtasking, with the following exceptions: 

1. The LRBs and LPRBs queued on the load 
list represent modules that are not 
reenterable. LRBs and LPRBs 
representing reenterable modules are 
queued on the job pack area queue. 

2. When a LOAD macro instruction is 
issued, the system searches the job 
pack area queue before searching the 
load list. 



reaches zero. An LLE has the following 
format: 



S -|»,V:?' 


t N«xt LLE 


Count 


fCDE 



Byte : Reserved (RES) . 

Bytes 1-3: Pointer to the next more recent 
LLE on the load list. 



Systems With MVT : Instead of LRBs and 
LPRBs created as a result of LOAD macro 
instructions, the load list maintained by a 
system with MVT contains elements 
representing load modules. Load list 
elements (LLEs) are associated with load 
modules through another control medium 
called the contents directory . 

The contents directory is made up of 
three separate queues: the link pack area 
control queue (LPAQ) . the lob pack area 
control queue (JPAQ) , and the load list . 

The LPAQ is a record of every program in 
the system link pack area. This area 
contains reenterable routines specified by 
the control program or by the user. The 
routines in the system link pack area can 
be used repeatedly to perform any task of 
any job step in the system. The entries in 
the LPAQ are contents directory entries 
(CDEs). 

There is a JPAQ for each job step in the 
system that uses a program not in the link 
pack area. The JPAQ, like the LPAQ, is 
made up of CDEs. It describes routines in 
a job step region. The routines in the job 
pack area can be either reenterable or not 
reenterable. These routines however, 
cannot be used to perform a task that is 
not part of the job step. 

The load list represents routines that 
are brought into a job pack area or found 
in the link pack area by the routines that 
perform the Load function. The entries in 
the load list are load list elements, not 
CDEs. Each load list element is associated 
with a CDE in the JPAQ or the LPAQ; the 
programs represented in the load list are 
thus also represented in one of the other 
contents directory queues. 

Load list elements also contain a count 
field that corresponds to the use count in 
a LPRB or LRB. Each time a LOAD macro 
instruction is issued for a load module 
already represented on the load list, the 
count is incremented by one. As 
corresponding DELETE macro instructions are 
issued, the count is decremented until it 



Byte 4: 



Count. 



Bytes 5-7: Pointer to the corresponding 
CDE. 

More will be said about CDEs in the next 
topic of Section 1, titled "Main Storage 
Supervision." 

Job Pack Area Queue (MFT With Subtaskinq 
Only) 

In an MFT system with subtasking, the job 
pack area queue is a chain of request 
blocks associated with load modules invoked 
by a LOAD macro instruction. The queue 
contains FRBs, and those LRBs and LPRBs 
that represent reenterable modules. FRBs 
are queued on the job pack area queue until 
the requested module is completely loaded. 
When the module is completely loaded into 
main storage, the FRB is removed from the 
job pack area queue and replaced with an 
LBR or an LPR queue on the job pack area 
queue if the loaded module is reenterable, 
and on the load list if it is not. 

In the MFT with subtasking 
configuration, the load list represents 
non-reenterable modules, while the job pack 
area queue represents cnly reenterable 
modules within the partition. These RBs on 
the job pack area queue are not deleted 
automatically, but remain intact until they 
are deleted by a DELETE macro instruction, 
or until job step termination occurs. 
Reenterable load modules are therefore 
retained in the partition for use by the 
job step task or any subtasks which may be 
created. 

Whenever a LOAD macro instruction is 
issued, the job pack area queue is 
searched. If the routine is already fully 
loaded and represented by an LRB or an LPRB 
on the JPAQ (the routine is reenterable), 
the system increments the use count by one 
and passes the module entry point address 
to the requesting routine. If an FRB for 
the requested module is found, a wait list 
element (WLE) representing the deferred 
request is queued to the FRB, and the 
request is placed in a wait. When the 
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requested routine is fully loaded, the 
system releases the request from the wait 
condition, and the request is re-initiated. 
If no RB for the requested routine is 
found, an FRB is created and queued on the 
JPAQ. The system then searches the load 
list of the requesting task for an RB for 
the requested routine. If an RB for that 
routine is found on the load list (the 
routine is not reenterable), the use count 
is incremented by one, the entry point 
address of the module is passed to the 
requesting routine, and the FRB is dequeued 
from the JPAQ. If no RB is found on the 
load list, the FRB remains on the JPAQ and 
the system begins loading the requested 
module . 



Each time a DELETE macro instruction is 
issued for the routine, the use count is 
decremented by one (the DELETE routine 
ignores FRBs). When the use count reaches 
zero, the RB is removed from the queue. 



Figure 5 illustrates how the job pack area 
queue is chained to a TCB. 

In Figure 5, each RB contains a pointer to 
the previous RB and a pointer to the next 
RB on the queue. If there is no previous 
RB on the queue, that pointer will contain 
zero; if there is no next RB on the queue 
(this RB is the most recent on the JPAQ) , 
the next RB pointer will point back to the 
job pack area queue pointer in the PIB. 




Two wait list elements (WLEs) are queued 
to FRB-C representing deferred requests 
waiting until the initial loading of the 
module is completed. The last WLE contains 
zero in its forward pointer, indicating 
that it is the last element on the WLE 
queue. 

Effects of LINK. ATTACH. XCTL. and LOAD 

LINK, ATTACH, XCTL, and LOAD, though 
similar, have some distinguishing 
characteristics and system dependencies 
worth mentioning. By knowing what happens 
when these macro instructions are issued, 
you can make more effective use of the 
active RB queue and the load list. 

LINK ; A LINK results in the creation of a 
PRB chained to the active RB queue. Upon 
completion of the invoked routine, control 
is returned to the invoking routine. In 
systems with MFT, the RB is removed from 
the queue. The storage occupied by the 
invoked routine is freed unless the routine 
is also represented on the load list, or on 
the job pack area queue in MFT systems with 
subtasking. In systems with MVT, the use 
count in the CDE is decremented by one; if 
it is then zero, the RB and the storage 
occupied by the routine are marked for 
deletion. A LINK macro instruction 
generates an SVC 6. 

ATTACH: An ATTACH is similar to the other 
three macro instructions in systems with 
MFT without subtasking. In systems with 
MFT with subtasking or MVT, ATTACH is the 
means for dynamically creating a separate 
but related task — a subtask. 

At the MFT without subtasking level, 
ATTACH effectively performs the same 
functions as LINK with two notable 
additions: 



1. 



2. 



You can request an exit routine to be 

given control upon normal completion 

of the attached routine. 

You can request the posting of an 

event control block upon the routine's 

completion. 



Figure 5* Job Pack Area Queue 



Exit routines are represented by additional 
RBs on the active RB queue. The ATTACH 
macro instruction generates an SVC 42 (2A). 

XCTL : An XCTL also results in the creation 
of a PRB and immediate transfer of control 
to the invoked routine. However, XCTL 
differs from the other macro instructions 
in that, upon completion of the invoked 
routine, control is passed to a routine 
other than the invoking routine. In fact, 
an XCTL does not result in the creation of 
a lower level RB. Instead, the invoking 
routine and its associated RBs are deleted 
when the XCTL is issued. In effect, the RB 
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for the invoked routine replaces the 
invoking routine's RB. The XCTL macro 
instruction generates an SVC 7. 

LOAD : The LOAD macro instruction was 
treated previously in the discussion of the 
load list. To summarize: the system 
responds to a LOAD by fetching the routine 
into main storage and passing the entry 
point address to the requesting routine in 
register 0* Because the system does not 
have an indication of when the routine is 
no longer needed, a LOAD must be 
accompanied by a corresponding DELETE macro 
instruction. If not, the routine and its 
RB remain intact until the job step is 
terminated- The LOAD macro instruction 
generates an SVC 8. 

System Task Control Differences 

Thus far, this topic has dealt with the 
aspects of task supervision that are 
similar for MFT and MVT. There are, 
however, some major differences: 

1. The number of tasks that can be known 
to the system concurrently. 

2. The layout of main storage. 

3. The additional main storage control 
information in systems with MVT. 

The first two subjects are discussed 
here, by system. The third subject, 
because of its volume, is discussed in the 
next topic of section 1. 

Systems With MFT (Without Subtasking) 

Figure 6 is a snapshot of main storage in a 
system with MFT without subtasking. 

The fixed area contains the nucleus 
(including TCB queue, transient area 
loading task, communications task, and 
master scheduler task), and the system 
queue area. Optionally it may contain 
access methods and SVC routine which are 
normally nonresident, a list of absolute 
addresses for routines which reside on 
direct access devices, and a reenterable 
load module area. 

One TCB exists for each task. All TCBs 
are linked by dispatching priority in a TCB 
queue, beginning with the three resident 
tasks. 

The dynamic area is divided into a 
maximum of 52 partitions. Each partition 
contains one task. The dynamic area can 
contain as many as 3 reading tasks, 36 
writing tasks, and 15 job step tasks, 
providing that the total number of tasks 
does not exceed 52. Partition sizes and 
attributes are defined during system 
generation. Figure 7 shows the contents of 
an MFT partition. 




Figure 6. Main Storage Snapshot (MFT 
Without Subtasking) 




Figure 7. Partition (MFT Without 
Subtasking) 
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Jobs are processed sequentially in a 
partition, one job step at a time. An 
ATTACH macro instruction does not create a 
subtask. 



Systems with MET (With Subtasking) : 
Operating Systems that provide 
multiprogramming with a fixed number of 
tasks with the subtasking option (MFT with 
subtasking) differ from MFT systems without 
subtasking in the following major areas: 



MPT with subtasking has an ATTACH 
facility similar to the ATTACH 
facility in MVT. While the number of 
job step TCBs still may not exceed 15, 
the number of tasks in any partition, 
and therefore the total number of 
tasks in the system, is now variable. 
Job step task TCBs reside in the 
nucleus. They are queued, following 
the system task TCBs, in the same 
manner as in MFT without subtasking. 
When subtasks are created, however, 
the subtask TCBs are placed in the 
system queue area and queued to the 
job step TCBs according to dispatching 
priority (TCBTCB field) , and according 
to subtask relationships (TCBNTC, 
TCBOTC, TCBLTC fields). 



MFT with subtasking provides the 
ability to change the dispatching 
priority of any task within a 
partition through the use of the CHAP 
macro instruction. 



Figure 8 is a snapshot of main storage in 
an MFT system with subtasking. Note here 
that the TCBs in the nucleus are all job 
step TCBs, while those residing in the 
sytem queue area are the subtask TCBs. 



Systems with MVT : In Operating Systems 
that provide multiprogramming with a 
variable number of tasks (MVT) , as many as 
15 job steps can be executed concurrently. 
Each job step requests an area of main 
storage called a region and is executed as 
a ipb step task . In addition, system tasks 
request regions and can be executed 
concurrently with job step tasks. 



Regions are assigned automatically from 
the dynamic area when tasks are initiated. 
Regions are constantly redefined according 
to the main storage requirements of each 
new task. 




Figure 8. Main Storage Snapshot (MFT With 
Subtasking) 

With the facility of attaching subtasks 
available to each task through the ATTACH 
macro instruction, the number of TCBs in 
the system is variable. Tasks gain control 
of the CPU by priority. To keep track of 
the priority and status of each task in the 
system, TCBs are linked together in a TCB 
queue. 

Figure 9 is a snapshot of main storage 
in a system with MVT. The fixed area is 
occupied by the resident portion of the 
control program loaded at IPL. The system 
queue space is reserved for control blocks 
and tables built by the control program. 
The dynamic area is divided into 
variable -sized regions, each of which is 
allocated to a job step task or a system 
task. Finally, the link pack area contains 
selected reenterable routines, loaded at 
IPL. If an IBM* 2361 Core Storage device 
and Main Storage Hierarchy Support are 
included in the system, a secondary link 
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pack area may be created in hierarchy 1 to 
contain other reenterable routines. 



Storage Control in Systems with MFT 
(Without Subtasking) 



LINK PACK 
AREA . 




FIXED 
AREA 



Figure 9. Main Storage Snapshot (MVT) 



Main Storage Supervision 

Storage control information is kept in a 
series of control blocks called queue 
elements . In systems with MFT without 
subtasking, queue elements reflect areas of 
main storage that are unassigned. In MFT 
systems with subtasking, a gotten sub task 
area queue element (GQE) is introduced to 
record storage obtained for a subtask by a 
supervisor issued GETMAIN macro 
instruction* In systems with MVT, more 
elaborate storage control is maintained; at 
any given time, queue elements reflect the 
distribution of main storage in regions, 
subpools, and load modules. 

The dynamic area may be significantly 
expanded by including IBM 2361 Core Storage 
in the system. Main Storage Hierarchy 
Support for IBM 2361 Models 1 and 2 permits 
selective access to either processor 
storage (hierarchy 0) or 2361 Core Storage 
(hierarchy 1). If IBM 2361 Core Storage is 
not included, requests for storage from 
hierarchy 1 are obtained from hierarchy 0. 
If 2361 Core Storage is not present in an 
MVT system and a region is defined to exist 
in two hierarchies, a two-part region is 
established within processor storage. The 
two parts are not necessarily contiguous. 



The chain of storage control information in 
an MFT system without subtasking begins at 
a table called the main storage supervisor 
(MSS) boundary box, located in the system 
nucleus. There is one MSS boundary box for 
each partition. It is pointed to by the 
TCB (TCBMSS field) for the partition. 

Each boundary box contains 3 words. The 
first word points to the Free Queue Element 
(FQE) associated with the highest free area 
in the partition. The second word points 
to the lowest limit of the partition. The 
third word contains the highest address in 
the partition plus 1. 

If Main Storage Hierarchy Support is 
included, the first half of each expanded 
boundary box describes the processor 
storage (hierarchy 0) partition segment, 
and- the second half describes the 2361 Core 
Storage (hierarchy 1) partition segment. 
Any partition segment not currently 
assigned storage in the system has the 
applicable boundary box pointers set to 
zero. If the partition is established 
entirely within hierarchy 0, or if 2361 
Core Storage is not included in the system, 
the hierarchy 1 pointers in the second half 
of the expanded boundary box are set to 
zero. If a partition is established 
entirely within hierarchy 1, the hierarchy 
pointers in the first half of the 
expanded boundary box are set to zero. 



FQE : Each free area in a partition is 
described by an FQE. FQEs are chained 
beginning with the FQE associated with the 
free area having the highest address in the 
partition. If Main Storage Hierarchy 
Support is present, one FQE chain exists 
for each hierarchy specified. Each FQE 
occupies the first 8 bytes of the area it 
describes. It has the following formats 



\ N«k» FQ£ 



Bytes 0-3: Pointer to FQE associated with 
next lower free area or, if 
this is the last FQE, zeros. 



Bytes 4-7: Number of bytes in the free 

Figure 10 summarizes storage control in 
systems with MFT without subtasking. 
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Figure 10, 



Storage Control for a Partition 
(MFT Without Subtasking) 



Storage Control in Systems with MFT (With 
Subtasking) 

Storage control information for the job 
step or partition TCB in MFT systems with 
subtasking is handled in the same way as in 
MFT systems without subtasking. However, 
when subtasks are created, the supervisor 
builds another control block, the gotten 
subtask area queue element (GQE). The GQEs 
associated with each subtask originate from 
a one word pointer addressed by the TCBMSS 
field of the subtask TCB. 



GQE : Each area in main storage belonging 
to a subtask,, and obtained by a supervisor 
issued GETMAIN macro instruction, is 
described by a gotten subtask area queue 
element (GQE) . GQEs are chained in the 
order they are created. The TCBMSS field 
of the subtask TCB contains the address of 
a word which points to the most recently 
created GQE. 



If Main Storage Hierarchy Support is 
present in the system, the GQE chain can 
span from hierarchy to hierarchy 1 and 
back in any order. Each GQE occupies the 
first eight bytes of the area it describes, 
and has the following format: 



: > ' ," '" 



* 



| ii | iiiii ;i lll U ' njyuM . i ! " I 



Bytes 0-3: Pointer to the Previous GQE or, 
if zero, this is the last GQE 
on the chain. 

Bytes 4-7: Number of bytes in the gotten 
subtask area. 

Figure 11 summarizes the chaining of GQEs 
to a subtask TCB. 
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Figure 11 



Storage Control for Subtask 
Storage (MFT With Subtasking) 



Storage Control for a Region in Systems 
with MVT 

Unassigned areas of main storage within 
each region of a system with MVT are 
reflected in a queue of partition queue 
elements (PQEs) and a series of free block 
queue elements (FBQEs). 
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PQE : The partition queue associated with a 
region resides in the system queue space. 
It is connected to the TCBs for all tasks 
in the job step through a dummy PQE located 
in the system queue space. A dummy PQE has 
the following formats 






'.'?<" Vi-ikk;, a-i 



t 



tsatPQE 



Bytes 13-15 (D-F): Pointer to the previous 
PQE or, if this is the first 
PQE, zeros. 

Bytes 17-19(11-13): Pointer to the TCB of 
the owning job step. 

Bytes 21-23(15-17): Size of the region, in 
2K (2048) bytes. 



Bytes 25-27 (19-1B) : Pointer to the first 
byte of the region. 



Bytes 0-3: Pointer to the first PQE in the 
partition queue. 

Bytes 4-7: Pointer to the last PQE in the 
partition queue. 

In systems that do not include the 
rollout/rollin feature or Main Storage 
Hierarchy Support for IBM 2361 Models 1 and 
2, there is one PQE for each job step. If 
the rollout feature is used, additional 
PQEs are added each time a job step borrows 
storage space from existing steps or 
acquires unassigned free space to satisfy 
an unconditional GETMAIN request. These 
additional PQEs are removed from the queue 
as the rollin feature is used. If Main 
Storage Hierarchy Support is present, one 
PQE exists for each hierarchy used by the 
job step. A PQE has the following format: 



Byte 28 (1C): Rollout flags. 



FBQE : The FBQEs chained to a PQE reflect 
the total amount of free space in a region. 
Each FBQE is associated with one or more 
contiguous 2K blocks of free storage area. 
FBQEs reside in the lowest part of their 
associated area. As area distribution 
within the region changes, FBQEs are added 
to and deleted from the free block queue. 

An FBQE has the following format: 
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t NextFBOi 



fU» 



JPr<M 
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f nntFiQE 



Res 



l"*" 08 1 



^ N«x*PQE 



:**♦; 
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12(C) 13(D) 



ft«$ j f Owning TCB 



Ret 



Region Size 



16(10) 17(11) 



20(14) 21 (15) 



*R*» m'', .; 









flegt 



R*» 



24(18) 25(19) 



28 (1C) 29 (ID) 



Bytes 1-3: Pointer to the first FBQE or, 
if there are no FBQEs, a 
pointer to the PQE itself. 

Bytes 5-7: Pointer to the last FBQE or, if 
there are no FBQEs, a pointer 
to the PQE itself. 

Bytes 9-11 (B): Pointer to the next PQE or, 
if this is the last PQE, zeros. 



Bytes 1-3: Pointer to the next lower FBQE 
or, if this is the last FBQE, a 
pointer to the PQE. 

Bytes 5-7: Pointer to the preceding FBQE, 
or, if this is the first FBQE, 
a pointer to the PQE. 



Bytes 8-11 (B): 



Number of bytes in the free 
block. 



The remaining main storage in a region 
is used by problem programs and system 
programs. For convenience in referring to 
storage areas, the total amount of space 
assigned to a task represents one or more 
numbered sub poo Is . (Subpools can also be 
shared by tasks.) Subpools are designated 
by a number assigned to the area through a 
GETMAIN macro inst inaction. Subpool numbers 
available for problem program use range 
from through 127. Subpool numbers 128 
through 255 are either unavailable or used 
by system programs. 

Storage control elements and queues for 
a region are summarized in Figure 12. 
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Figure 12. storage Control for a Region 
(MVT) 

Stora ge Control for a Subpool in Systems 
with MVT 

Main storage distribution within each 
subpool is reflected in a subpool queue 
element (SPQE) and queues of descriptor 
queue elements (DQEs) and free queue 
elements (FQEs). 

SPQE : SPQEs are associated with the 
subpools created for a task. SPQEs reside 
in the system queue space and are chained 
to the TCB(s) that use the subpool. They 
serve as a link between the TCB and the 
descriptor queue, and may be part of a 
subpool queue if the task. uses more than 
one subpool. If a subpool is used by more 
than one task, only one SPQE is created. 
An SPQE has the following formats 







SP' 


t first DQE 



Byte 0: 
Bit 



- Subpool is owned by this task 
if zero; shared, and owned by 
another task, if one. 
Bit 1 - This SPQE is the last on the 

queue, if one. 
Bit 2 - Subpool is shared and owned by 

this task, if one- 
Bits 3-7 - Reserved. 



Bytes 1-3: Pointer to next SPQE or, in 
last SPQE, zero. 



Byte 4: Subpool number. 



Bytes 5-7: Pointer to first DQE or, if the 
subpool is shared, a pointer to 
the "owning" SPQE. 



DQE : DQEs associated with each SPQE 
reflect the total amount of space assigned 
to a subpool. Each DQE is associated with 
one or more 2K block3 of main storage set 
aside as a result of a GETMAIN macro 
instruction. Each DQE is also the starting 
point for the free queue. A DQE has the 
following format: 



rW ' 


''-* t First FQE 


Rw 


;l f Next DQE > 


1 


4 


5 


J£ 


f f 1r»t 2K block 


■;:;•&•*■■'■ 


::;. . Urtgth of orwj ,,,.. 



12(C) 13(D) 



Bytes 1-3: Pointer to the FQE associated 
with the first free area. 

Bytes 5-7: Pointer to the next DQE or, if 
this is the last DQE, zeros. 

Bytes 9-11 (B): Pointer to first 2K block 
described by this DQE. 

Bytes 13-15 (D-F): Length in bytes of area 
described by this DQE. 

FQE : The FQE describes a free area within 
a set of 2K blocks described by a DQE. It 
occupies the first eight bytes of that free 
area. Since the FQE is within the subpool, 
it has the same protect key as the task 
active within that subpool. Extreme care 
should be exercised to see that FQEs are 
not destroyed by the problem program. If 
an FQE is destroyed, the free space that it 
describes is lost to the system and cannot 
be assigned through a GETMAIN. As area 
distribution within the set of blocks 
changes, FQEs are added to and deleted from 
the free queue. An FQE has the following 
format: 



Res 



£. "•£ s -, < -! 



| Nwt FQ£ 



R«< 



Number of bytes 
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Bytes 1-3: Pointer to the next lower FQE 
or, if this is the last FQE, 
zeros. 



Bytes 5-7: Number of bytes in the free 
area. 



Storage control for a subpool is 
summarized in Figure 13. 




SYSTEM 
QUEUE <J 
SPACE 



Figure 13. Storage Control for a Subpool 
(MVT) 



Storage Control for a Load Module in 
Systems With MVT 

Each load module in main storage is 
described by a contents directory entry 
(CDE) and an extent list (XL) that tells 
how much space it occupies. 



CDE : The contents directory is a group of 
queues, each of which is associated with an 
area of main storage. The CDEs in each 
queue represent the load modules residing 
in the associated area. There is a CDE 
queue for the link pack area and one for 
each region, or job pack area. The TCB for 
the job step task that requested the region 
Contents directory queues reside in the 
system queue space. A CDE has the 
following format: 



{ N«xt CDE 



Rot 



tf?B 



EBCDIC program nam* 



? €Sounf 



t Entry point 



Flags 






16(10) 17(11) 



20(14) 21(15) 



Byte 0: Flag bits, when set to one, 
indicate: 
Bit - Module was loaded by NIP. 
Bit 1 - Module is in process of teing 

loaded. 
Bit 2 - Module is reenterable. 
Bit 3 - Module is serially reusable. 
Bit 4 - Module may not be reused. 
Bit 5 - This CDE reflects an alias 

name (a minor CDE). 
Bit 6 - Module is in job pack area. 
Bit 7 - Module is not only- loadable. 



Bytes 1-3: Pointer to next CDE. 

Bytes 5-7: Pointer to the RB. 

Bytes 8-15 (F): EBCDIC name of load module. 

Byte 16(10): Use count. 



Bytes 17-19(11-13): Entry point address of 
load module. 



Byte 20: Flag bits, when set to one, 

indicate: 
Bit - Reserved. 
Bit 1 - Module is inactive. 
Bit 2 - An extent list has been built 

for the module. 
Pit 3 - This CDE contains a relocated 

alias entry point address. 
Bit 4 - The module is refreshable. 



Bits 5, 6, 7 



Reserved. 



Bytes 21-23(15-17): Pointer to the XL for 
this module or, if this is a 
minor CDE, pointer to the 
major CDE. 



XL : The total amount of main storage 
occupied by a load module is reflected in 
an extent list (XL) . XLs are located in 
the system queue space. An XL has the 
following format: 
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i ,Unjrt» » f CSECT-1 



•ttnsi* of \ 4CSECT - H 



12(C) 







* ' 



^^ 



of ( ( CSECT - N 



Bytes 0-3: Length of XL in bytes. 

Bytes 4-7: Number of scattered control 
sections. If the control 
sections are block-loaded, 1. 

Remaining Length in bytes of each 

bytes : control section in the module 
(4 bytes for each control 
section) and starting location 
of each control section (4 
bytes for each control 
section) . 




Figure 14. Storage Control for a 
Module (MVT) 



Load 



Storage control elements and queues for 
load modules are summarized in Figure 14. 



System Control Blocks and Tables 



In addition to the key task management 
control blocks (TCB and RB), several other 
control blocks containing essential 
debugging information are built and 
maintained by data management and job 
management routines. Although some of 
these blocks are not readily identifiable 
on a storage dump, they can be located by 
following chains of pointers that begin at 
the TCB- 



The control blocks discussed here have 
the same basic functions at each control 
program level. The precise byte-by-byte 
contents of the blocks can be found in the 
publication System Control Blocks . Block 
contents useful in debugging are listed in 
Appendix K. 



Communications Vector Table (CVT) 

The CVT provides a means of communication 
between nonresident routines and the 
control program nucleus. Its most 
important role in debugging is its pointer 
to two words of TCB addresses. These words 
enable you to locate the TCB of the active 
task, and from there to find other 
essential control information, storage 
locations 16(10) and 76 (4c) contain a 
pointer to the CVT. 



Task Input/Output Table (TIOT) 

A TIOT is constructed by job management for 
each task in the system. It contains 
primarily pointers to control blocks used 
by I/O support routines. It is usually 
located in the highest part of the main 
storage area occupied by the associated 
task (in systems with MVT, TIOTs are in the 
system queue space.) Through the TIOT, you 
can obtain addresses of unit control blocks 
allocated to the task, the job and step 
name, the ddnames associated with the step, 
and the status of each device and volume 
used by the data sets. 
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Unit Control Block (UCB) 

The UCB describes the characteristics of an 
I/O device. One UCB is associated with 
each I/O device configured into a system. 
The UCB's most useful debugging aid is the 
sense information returned by the last 
sense command issued to the associated 
device. 



to some other control blocks. The DEB is 
created and queued to the TCB at the time a 
data set is opened. Each TCB contains a 
pointer to the first DEB on its chain. 
Through this pointer you can find out which 
data sets are opened for the task at a 
given time, what extents are occupied by 
open data sets, and where the DCB and UCB 
are located. 



Event Control Block (ECB) 

The ECB is a 1-word control block created 
when a READ or WRITE macro instruction is 
issued, initiating an asynchronous I/O 
operation. At the completion of the I/O 
operation, the access method routine posts 
the ECB. By checking this ECB, the 
completion status of an I/O operation can 
be determined. In all access methods but 
QTAM, the ECB is the first word of a larger 
block, the data event control block. 

Input /Output Block (IOB) 

The IOB is the source of information 
required by the I/O supervisor. It is 
filled in with information taken from an 
I/O operation request. In debugging, it is 
useful as a source of pointers to the DCB 
associated with the I/O operation and the 
channel commands associated with a 
particular device. 

Data Control Block (DCB) 

The DCB is the place where the operating 
system and the problem program store all 
pertinent information about a data set. It 
may be completely filled by operands in the 
DCB macro instruction, or partially filled 
in and completed when the data set is 
opened, with subparameters in a DD 
statement and/or information from the data 
set label. The format of DCBs differs 
slightly for each of the various access 
methods and device types. The DCB's 
primary debugging aids are -its pointers to 
the DEB and current IOB associated with its 
data set, and the offset value of the 
ddname in the TIOT. 

Data Extent Block (DEB) 

A DEB describes a data set*s auxiliary 
storage assignments and contains pointers 



Summary of Control Block Relationships 

Figure 15, an expansion of Figure 1, shows 
the relationships among the principal 
control blocks and tables in the System/360 
Operating System. 



Location 

fey,- C==C> 

16(10) 



+4 



(J 



c v, 



+0 TCB Word$ 



V 



+4 



+1 







/ ' J 


■ ... 


\ 



£ 
£& 






+13(D) 







+9 



+ 25(19) 



m 



s 



<r 



=s- 



+68 
(44) 



\ 



+45 (2D) 



+33(21) 



V 



n* 



t|ob 



*» 



1(15) 



+17(11) 



% 






Figure 15. Control Block Relationships 
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Section 2: Interpreting Dumps 



Topics composing Section 2 are: 

• ABEND/SNAP dumps issued by systems with 
MFT. 

• ABEND/SNAP dumps issued by systems with 
MVT. 

• Indicative dumps. 

• Storage dumps. 

Each topic includes instructions for 
invoking the dump, a detailed description 
of the dump's contents, and a guide to 
using the dump. 



ABEND/SNAP Dump (MFT) 

ABEND/SNAP storage dumps are issued 
whenever the control program or problem 
program issues an ABEND or SNAP macro 
instruction, or the operator issues a 
CANCEL command requesting a dump, and 
proper dump data sets have been defined. 
However, in the event of a system failure, 
if a SYS1.DUMP data set has been defined 
and is available, a full storage dump will 
be provided, as explained in the section 
"Storage Dumps.'' 

Since, in an MFT with subtasking system, 
subtasks may be created, you may receive 
one or more partial dumps in addition to 
the complete dump of the task that caused 
the abnormal termination. A complete dump 
includes a printout of all control 
information related to the terminating 
task, and the nucleus and all allocated 
storage within the partition in which the 
abend ing task resided. A partial dump of a 
task related to the terminating task 
includes only control information. The 
partial dump is identified by either ID=001 
or ID=002 printed in the first line of the 
dump. Figure 16 is a copy of the first few 
pages of a complete ABEND dump of an MFT 
system with subtasking. It illustrates 
some of the key areas on an ABEND dump, as 
issued by systems with MFT. Those portions 
of the dump that would only appear on a 
dump of a subtasking system are noted in 
the later discussions as appearing only in 
a dump of an MFT with subtasking system. 

For a discussion of a formatted ABEND 
dump using the telecommunications acce s 
method (TCAM) in an MFT environment, see 
IBM System/360 Operating System: TCAM 
Program Logic Manual , GY30-2029. 
References to other TCAM debugging aids are 
found in Appendix J. 



Invoking an ABEND/SNAP Dump (MFT) 

ABEND dumps are produced as a result of an 
ABEND macro instruction, issued either by a 
processing program or an operating system 
routine. The macro instruction requires a 
DD statement in the input stream for each 
job step that is subject to abnormal 
termination. This DD statement must be 
identified by one of the special ddnames 
SYSABEND or SYSUDUMP . SYSABEND results in 
edited control information, the system 
nucleus, the trace table, and a dump of 
main storage; SYSUDUMP excludes the nucleus 
and the trace table. In the event of a 
system failure, the Damage Assessment 
routine (DAR) attempts to write a storage 
image dump to the SYS1.DUMP data set. A 
full explanation of storage dumps may be 
found in the section "Storage Dumps." 



SNAP Dumps result from a problem program 
issuing a SNAP macro instruction. The 
contents of a SNAP dump vary according to 
the operands specified in the SNAP macro 
instruction. SNAP dumps also require a DD 
statement in the input stream. This DD 
statement has no special characteristics 
except that its ddname must not be SYSABEND 
or SYSUDUMP. The processing program must 
define a DCB for the snapshot data set. 
The DCB macro instruction must contain, in 
addition to the usual DCB requirements, the 
operands DSORG=PS, RECFM=VBA, MACRF=(W), 
BLKSIZE=882 or 1632, and LRECL=125. In 
addition, the DCB must be opened before the 
first SNAP macro instruction is issued. 



Main storage Considerations : Three BSAM 
modules (IGG019BA, IGG019BB, and the 
device -de pendent EOB module) are required 
to process dumps. These modules should be 
made resident in the Resident Access Method 
(RAM) area by specifying RESIDNT=ACSMETH in 
the SUPRVSOR macro instruction during 
system generation. If these modules are 
not resident, as much as 1352 bytes of main 
storage within the partition are required 
to contain them. 



In addition to the area required for the 
BSAM modules, 2784 bytes must be available 
in the partition. 1344 of these bytes are 
required for EOV processing should the 
initial space specification for a direct 
access device be exceeded by the dump 
requirements. 
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Figure 16. Sample of an ABEND Dump (MFT) (Part 1 of 2) 
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SAVE AREA TRACE 






PAGE 0002 






TATHB10C MAS ENTERED 














SA 06EBFB WOl 0606EAC8 HSA OOOOO 100 ISA 0006EE60 


RET 000098*8 EPA *006EE*8 


RO 


000098CE 








Rl 0001CC80 R2 00000000 R3 00080000 


R* O00TFE*R R5 00000098 


R6 


00005508 








R7 0007FC30 R8 0006ECEO R9 0007FF78 


RIO 0007FFB0 Rll 0007FFF8 


R12 


*006ECCE 








SA 06EE60 WOl 00000000 HSA 0006EBF8 ISA 00000000 


RET 00000000 EPA 00000000 


RO 


00000000 








Rl 00000000 R2 00000000 R3 00000000 


R* 00000000 R5 00000000 


R6 


00000000 








R7 00000000 R8 00000000 R9 00000000 


RIO 00000000 Rll 00000000 


R12 


00000000 








PROCEEDING BACK VIA REG 13 














SA 06EE60 WOl 00000000 HSA 0006EBF8 ISA 00000000 


RET 00000000 EPA 00000000 


RO 


00000000 








Rl 00000000 R2 00000000 R3 00000000 


R* 00000000 R5 00000000 


R6 


00000000 








R7 00000000 RB 00000000 R9 00000000 


RIO 00000000 Rll 00000000 


R12 


00000000 








TATHB10G WAS ENTERED 














SA 06EBF8 WOl 0606EAC8 HSA 00000100 ISA 0006EE60 


RET 000098*8 EPA *006EE*8 


RO 


00009 8CE 








Rl 0001CC80 R2 00000000 R3 00080000 


R* 0007FE*8 R5 00000098 


R6 


00005508 








R7 0007FC30 R8 0006ECEO R9 0007FF78 


RIO 0007FFBO Rll 0007FFF8 


R12 


*006ECCE 








DATA SETS 














SNAP2 UC8 192 00225C OEB 07FT8C 


JCB 06EFB* 












OUMOCB UCB 192 00225C DEB 07FAF* 0C8 06EF5C 












JOBUB UCB 190 0OZ18C 














SYSPRtNT UCB 192 00225C 














SVSABENO UCB 192 00225C 














SNAP1 UCB 190 00218C 














REGS AT ENTRY TO ABEND 














FL.PT.REGS 0-6 00.000000 00000000 00,000000 00000000 00.000000 00000000 




00.000000 00000000 








REGS 0-7 000002A0 8000007B 00000000 00080000 0007FE48 00000098 


00005508 0007FC30 








REGS 8-15 0006EE60 0007FF78 0007FFB0 0007FFF8 *006EE*E 0006EE60 


000098*8 00000000 








NUCLEUS 














000000 OOOCCOOO 0000051C F0F0F5C1 00000000 000097F8 


00013**0 010*0080 8003 ACO* « 




...005A .8 


...M* 






000020 000*000A 500066*6 00000000 00000000 OOOOFFOO 


00000000 FF0*000E A0007E2A • 


.. . .< 


««•.••...•••••.•••.•»• 


.«..* 






0000*0 1007F5E8 50000000 00001*80 000097F8 60C85DC0 


00000000 000*0000 000002 82 ♦ 


..5Y 


........ ..S.H... 


....* 






000060 000*0000 0000033A 000*0000 0000020E 00000000 


0000B278 000*0000 00000226 * 


.... 


.•••••...••........«.. 


....* 






000080 00015380 00000000 00000000 00003000 00000000 


00000000 00000000 00000000 • 


... . 


...................... 


....* 






OOOOAO OOOOCOOO 00000000 00000000 00000000 00000000 


00000000 00000000 00000000 • 


... . 





....* 






LINES OOOOCO-000140 SANE AS ABOVE 














000160 00000000 00000000 00000000 82000170 000*0000 


0003A7AO 00000000 00000000 * 


• .. • 


...................... 


* 






000180 0001CB20 00007E91 0006F*65 80007016 00000080 


0006F*91 00000001 0006F*A8 * 


.. . . 


* *.... 


..*.* 






000 1A0 00000000 00000000 00000000 00000000 00000000 


00000000 00000000 cooooooo * 


.... 


, 


. ...» 






LINE OOOICO SAME AS ABOVE 














0001EO 000079F0 00006888 0000A*3A 00000001 *0007720 


0000*0*2 90001520 00000000 • 


...0 


............ .......... 


...... 






000200 00008*6C 0000836* 00006780 000069*2 00001000 


00000F28 00009730 0001335C • 


....< 


..U 


• ...* 






000220 000133*0 0023*700 02*C96F0 02279029 01805830 


06C*58*0 3000*700 025C0207 * 




0. ....... .0. ... 


...K.« 






0002*0 *0100038 9*FD*011 90A13030 5890021C 05895850 


02105890 02l*07F9 90A101E0 » 


... 


9....* 






000260 02070**0 0038*7F0 02*C9*OF 02279829 018091F0 


0238*780 0**898Al 01E08200 * 




..0..... 0.. 


• •••• 






000280 0**09C29 018091F0 0238*780 029C90A1 01E0D207 


0**00018 *7F002B2 S89006C* » 


. . . 


..0 K 0. 


...D* 






00O2A0 90A1903C 58990000 02079010 00lfl9*FD 901191*0 


0018*780 O2C0582O 020*0522 ♦ 


.. . . 


...K. ......... ....... 


..*..• 






0002CO 9180001B *78002CE 58200208 0522*7F0 026A0000 


00015388 0000870A 0A0390A9 * 


. . • • 


......Q...0 


. • ••* 






0002E0 01A098CD 00285880 02189101 0029078B 58A006C* 


5SA0A00* 12AA07CB 18BA58AA • 


... . 


..............0....... 


• ...» 






000300 000012AA *7CO0332 90C2B00* 181B58B0 02189280 


100098FO A0008900 C0001200 * 


.. .. 


....P 0... 


. ...* 






000320 078850FO 002C*1EO 02DC98AD 01A08200 0028181B 


58800218 07FB900F 0*005890 • 


...0. 





. ...» 



















Figure 16. Sample of an ABEND Dump (MFT) (Part 2 of 2) 
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Device and Space Considerations : DD 
statements for ABEND/SNAP dumps, must 
contain parameters appropriate for a basic 
sequential (BSAM) data set. Data sets can 
be allocated to any device supported by the 
basic sequential access method. There are 
several ways to code these DD statements 
depending on what type of device you choose 
and when you want the dump printed. 



If you wish to have the dump printed 
immediately, code a DD statement defining a 
printer data set. 



j //SYSABEND DD UNIT=1443,DCB=(. . 



A printer is associated with the SYSOUT 
class,, you can also obtain immediate 
printing by routing the data set through 
the output stream. 



|//SNAPDUMP DD SYSOUT=A, DCB=(, 

L 



This type of request is the easiest, 
most economical way to provide for a dump. 
All other DD statements result in the tying 
up of an output unit or delayed printing of 
the dump. 

If you wish to retain the dump, you can 
keep or catalog it on a direct access or 
tape unit. The last step in the pertinent 
job can serve several functions: to print 
out key data sets in steps that have been 
abnormally terminated, to print- an ABEND or 
SNAP dump stored in an earlier step, or to 
release a tape volume or direct access 
space acquired for dump data sets. 
Conditional execution of the last step can 
be established through proper use of the 
COND parameter and its subparameters, EVEN 
and ONLY, on the EXEC statement. 



Direct access space should be requested 
in units of average block size rather than 
in cylinders (CYL) or tracks (TRK) . If 
abnormal termination occurs and the data 
set is retained, the tape volume or direct 
access space should be released (DELETE in 
the DISP parameter) at the time the data 
set is printed. 

Sample DD Statements : Figure 17 shows a 
set of job steps that include DD statements 
for ABEND dump data sets. 

The SYSABEND DD statement in STEP2 takes 
advantage of the direct access space 
acquired in STEP1 by indicating MOD in the 
DISP parameter. Note that the space 
request in STEP1 is large so that the 
dumping operation is not inhibited due to 
insufficient space. The final SYSABEND DD 
statement in the job should indicate a 
disposition of DELETE to free the space 
acquired for dumping. 

Contents of an ABEND/SNAP Dump (MFT) 

This explanation of the contents of 
ABEND/SNAP dumps for systems with MFT is 
interspersed with sample sections taken 
from an ABEND dump. Capital letters 
represent the headings found in all dumps, 
and lowercase letters, information that 
varies with each dump. The lowercase 
letter used indicates the mode of the 
information, and the number of letters 
indicates its length: 

• h represents 1/2 byte of hexadecimal 
information 

• d represents 1 byte of decimal 
information 

• c represents a 1-byte character 

You may prefer to follow the explanation 
on your own ABEND or SNAP dump. 
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PC M=P 


KOCRA 
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H//STEP/ 


EXEC 


















■//SYSABEJ 
■// 


join-. 


DSMAM 
VOLUM 


E=DUM 


P t UUI 
= »23«* 


Ts23l 
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«;DISPs^ ,K 
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EEP) A 
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, t&tcn 


«nts 
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— __ 
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■//STEP2 


EXEC 


PGM=P 


ROGRA 


M2 




















■//SYSABEI 


ID DD 


DSNAM 


E»*.S 


TEPl. 


SYSAB 


ENOjD 
BEND 


1 3I>«( 


Mpp.o 


ELETf 


i KEEP 


h-.. 


X 


■// 




VOl-R 


EF»*. 


STEPf 


.SYS A 























































































































































































































Figure 17. SYSABEND DD Statements 
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» • MIDH P REQUESTED*** 
•cccocco... 
JOB cccccccc STEP cccccooc TIME dddddd DATE ddddd 

COMPLETION CODE SYSTEM - hhh (or USER « dddd) 
cecece, . . 

INTERRUPT AT hhhhhh 
PSW AT EHTRY TO ABEND (SNAP) hhhhhhhh hhhhhhhh 



PAGE dddd 



♦ ♦♦ABDUMP REQUESTED*** 
identifies the dump as an ABEND or 
SNAP dump. 



♦ccccccc 

is omitted or is one or more of the 
following: 

♦CORE NOT AVAILABLE, LOC. 

hhhhhhhhhhhh TAKEN... 

indicates that the ABDUMP routine 
confiscated storage locations 
hhhhhh through hhhhhh because not 
enough storage was available. 
This area is printed under P/P 
STORAGE, but can be ignored 
because the problem program 
originally in it was overlaid 
during the dumping process. 

♦MODIFIED, /SIRB/DEB/LLS/ARB/MSS. . . 
indicates that the one or more 
queues listed were destroyed or 
their elements dequeued during 
abnormal termination: 

• SIRB — system interruption 
request block queue. One or 
more SIRB elements were found 
in the active RB queue: these 
elements are always dequeued 
during dumping. 

• DEB — DEB queue. If the first 
message also appeared, either a 
DEB or an associated DCB was 
overlaid. 

• LLS — load list. If the first 
message also appeared, one or 
more loaded RBs were overlaid. 

• ARB — active RB queue. If the 
first message also appeared, 
one or more RBs were overlaid. 

• MSS — boundary box queue. One 
or more MSS elements were 
dequeued, but an otherwise 
valid control block was found 



in the free area specified by 
an MSS element. 

♦FOUND ERROR IN /DEB/LLS/ARB/MSS . . . 

indicates that one or more of the 
following contained an error: 

• DEB: data extent block 

• LLS: load list 

• ARB: active RB 

• MSS: boundary box 

This message appears with either 
the first or second message 
above. The error could be: 
improper boundary alignment, 
control block not within storage 
assigned to the program being 
dumped, or an infinite loop (300 
times is the maximum for this 
test). For an MSS block, 4 other 
errors could also be found: 
incorrect descending sequence 
(omitting loop count), 
overlapping free areas, free area 
not entirely within the storage 
assigned to the program being 
dumped, or count in count field 
not a multiple of 8. 

JOB cccccccc 

is the job name specified in the JOB 
statement. 

STEP cccccccc 

is the step name specified in the EXEC 
statement for the problem program 
being dumped. 

TIME dddddd 

is the hour (first 2 digits) , minute 
(second 2 digits) , and second (last 2 
digits) when the ABDUMP routine began 
processing. 

DATE ddddd 

is the year (first 2 digits) and day 
of the year (last 3 digits). For 
example, 67352 would be December 18, 
1967. 
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PAGE dddd 

is the page number, 
top of each page. 



Appears at the 



COMPLETION CODE SYSTEM=hhh or COMPLETION 

CODE USER=dddd 

is the completion code supplied by the 
control program (SYSTEM=hhh) or the 
problem program (USER=dddd). Either 
SYSTEM=hhh or USER=dddd is printed, 
but not both. Common completion codes 
are explained in Appendix B. 

cccccc. . . 

explains the completion code or, if a 
program interruption occurred; 
PROGRAM INTERRUPTION CCCCC. . . AT 
LOCATION hhhhhh, 

where ccccc is the program 
interruption cause — OPERATION, 

PRIVILEGED OPERATION, EXECUTE, 
PROTECTION, ADDRESSING, SPECIFICATION, 



DATA, FIXED-POINT OVERFLOW, FIXED- POINT 
DIVIDE, DECIMAL OVERFLOW, DECIMAL 
DIVIDE, EXPONENT OVERFLOW, EXPONENT 
UNDERFLOW, SIGNIFICANCE, or 
FLOATING-POINT DIVIDE; and hhhhhh is 
the starting address of the 
instruction being executed when the 
interruption occurred. 

INTERRUPT AT hhhhhh 

is the address of next instruction to 
be executed in the problem program. 
It is obtained from the resume PSW of 
the PRB or LPRB in the active RB queue 
at the time abnormal termination was 
requested. 

PSW AT ENTRY TO ABEND hhhhhhhh hhhhhhhh or 
PSW AT ENTRY TO SNAP hhhhhhhh hhhhhhhh 

is the PSW for the problem or control 
program that had control when abnormal 
termination was requested or when the 
SNAP macro instruction was executed. 



TCB 


hhhhhh RB 


hhhhhhhh PIE hhhhhhhh 


DEB hhhhhhhh TIOT 


hhhhhhhh 


CMP hhhhhhhh 


TRN hhhhhhhh 




MSS 


hhhhhhhh PK/FLG hhhhhhhh 


FLG hhhhhhhh I.LS 


hhhhhhhh 


JLB hhhhhhhh 


JST hhhhhhhh 




RG 0- 


•7 hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 




RG 8- 


-15 hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 




FSA 


hhhhhhhh TCB hhhhhhhh 


TME hhhhhhhh PIB 


hhhhhhhh 


NTC hhhhhhhh 


OTC hhhhhhhh 




LTC 


hhhhhhhh IQE hhhhhhhh 


ECB hhhhhhhh XTCB 


hhhhhhhh 


LP/FL hhhhhhhh 


RESV hhhhhhhh 




STAE 


hhhhhhhh TCT hhhhhhhh 


USER hhhhhhhh DAR 


hhhhhhhh 


RESV hhhhhhhh 


JSCB hhhhhhhh 



TCB hhhhhh 

is the starting address of the TCB. 

RB hhhhhhhh 

is the TCBRBP field (bytes through 
3) : starting address of the active RB 
queue and, consequently, the most 
recent RB on the queue (usually 
ABEND'S RB). 

PIE hhhhhhhh 

is the TCBPIE field (bytes 4 through 
7): starting address of the program 
interruption element (PIE) for the 
task. 

DEB hhhhhhhh 

is the TCBDEB field (bytes 8 through 
11) : starting address of the DEB 
queue. 

TIOT hhhhhhhh 

is the TCBTIO field (bytes 12 through 
15) : starting address of the TIOT. 

CMP hhhhhhhh 

is the TCBCMP field (bytes 16 through 
19) : task completion code in 
hexadecimal. System codes are shown 



in the third through fifth digits and 
user codes in the sixth through 
eighth. 



TRN hhhhhhhh 

is the TCBTRN field (bytes 20 through 
23): starting address of control core 
(table) for controlling testing of the 
task by TESTRAN. 

MSS hhhhhhhh 

is the TCBMSS field (bytes 24 through 
27) : starting address of the main 
storage supervisor's boundary box. 

PK/FLG hhhhhhhh 

contains, in the first 2 digits, the 
TCBPKF field (byte 28): protection 
key. 

FLG hhhhhhhh 

contains, in the first 4 digits, the 
last 2 bytes of the TCBFLGS field 
(bytes 32 and 33): last 2 flag bytes. 

contains, in the next 2 digits, the 
TCBLMP field (byte 34) : number of 
resources on which the task is queued. 
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contains, in the last 2 digits, the 
TCBDSP field (byte 35): 



• Reserved in MFT without subtasking; 
both digits are zero. 



In MFT with subtasking, this field 
contains the dispatching priority of 
the TCB. 



LLS hhhhhhhh 

is the TCBLLS field (bytes 36 through 
39): starting address of the RB 
most recently added to the load 
list. 



JLB hhhhhhhh 

is the TCBJIJB field (bytes 40 through 
43): starting address of the DCB 
for the JOBLIB data set. 



JST hhhhhhh 

is the TCBJST field (bytes 44 through 
47). Not currently used in MFT 
without subtasking. In MFT with 
subtasking - the starting address of 
the TCB for the job step task. 



RG 0-7 and RG 8-15 

is the TCBGRS field (bytes 48 through 
111) : contents of general registers 
through 7 and 8 through 15, as stored 
in the save area of the TCB when a 
task switch occurred. These 2 lines 
appear only in TCBs of tasks other 
than the task in control when the dump 
was requested. 



FSA hhhhhhhh 

contains, in the first 2 digits, the 
TCBIDF field (byte 112) : TCB 
identifier field. 

contains, in the last 6 digits, the 
TCBFSA field (bytes 113 through 115): 
starting address of the first problem 
program save area. This save area was 
set up by the control program when the 
job step was initiated. 

TCB hhhhhhhh 

is the TCBTCB field (bytes 116 through 
119): starting address of the next 
TCB of lower priority or, if this is 
the last TCB, zeros. 



TME hhhhhhhh 

is the TCB TME field (bytes 120 through 
123): starting address of the timer 
element created when an STIMER macro 
instruction is issued by the task. 
This field is not printed if the 
computer does not contain the timer 
option. 

PIB hhhhhhhh 

is the TCBPIB field (bytes 124 through 
127): starting address of the program 
information block. 

OTC hhhhhhhh 

is the TCBNTC field (bytes 128 through 
131): 

MFT without subtasking: zeros. 

MFT with subtasking: the starting 
address of the TCB for the previous 
subtask on this subtask TCB queue. 
This field is zero both in the job 
step task, and in the TCB for the 
first subtask created by a parent 
task. 

CTC hhhhhhhh 

is the TCBOTC field (bytes 132 through 
135): starting address of the TCB for 
the parent task. Both in the TCB for 
the job step task, and in MFT systems 
without subtasking this field is zero. 

LTC hhhhhhhh 

is the TCBLTC field (bytes 136 through 
139) : starting address of the TCB for 
the most recent subtask created by 
this task. This field is zero in the 
TCB for the last subtask of a job 
step, or in the TCB for a task that 
does not create subtasks. This field 
is always zero in an MFT system 
without subtasking . 

hhhhhhhh 

is the TCBIQE field (bytes 140 through 

143). 

MFT without subtasking: zero. 

MFT with subtasking: starting address 
of the interruption queue element 
(IQE) for the ETXR exit routine. This 
routine is specified by the ETXR 
operand of the ATTACH macro 
instruction that created the TCB being 
dumped. The routine is to be entered 
when the task terminates. 

ECB hhhhhhhh 

is the TCBECB field (bytes 144 through 
147). 
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MFT without subtasking: zero. 

MFT with subtasking: starting address 
of the ECB field to be posted by the 
control program at task termination. 
This field is zero if the task was 
attached without an ECB operand. 

XTCB hhhhhhhh 

reserved for future use. 



TCT hhhhhhhh 

is the TCBTCT field (bytes 164 through 
167): 



Address of the Timing Control Table 
(TCT): zeros if the System Management 
Facilities option is not present in 
the system. 



LP/FL hhhhhhhh 

MFT without subtasking: 



reserved. 



MFT with subtasking: contains in the 
first byte, the limit priority of the 
task (byte 152). contains, in the 
last three bytes the field TCBFTFLG 
(bytes 153 through 155) - flag bytes. 

RESV hhhhhhhh 

reserved for future use. 

STAE hhhhhhhh 

contains, in the first 2 digits, STAE 
flags (byte 160). 

contains, in the last 6 digits, the 
TCBNSTAE field (bytes 161 through 
163) : starting address of the current 
STAE control block for the task. This 
field is zero if STAE has not been 
issued. 



USER hhhhhhhh 

is the TCBUSER field (bytes 168 
through 171): to be used as the user 
chooses. 

DAR hhhhhhhh 

contains, in the first 2 digits. 
Damage Assessment Routine (DAR) flags 
(byte 172); 

contains, in the last 6 digits, the 
secondary non-dispatchability bits 
(bytes 173 through 175). 

RESV hhhhhhhh 

reserved for future use. 

JSCB hhhhhhhh 

is the TCBJSCB field (bytes 180 
through 183): the last three bytes 
contain the address of the Job Step 
Control Block. 



ACTIVE RBS 



cccc hhhhhh 



NM cccccccc SZ/STAB hhhhhhhh USE/EP hhhhhhhh PSW hhhhhhhh hhhhhhhh Q hhhhhh WT/LNK hhhhhhhh 
RG 0-7 hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
RG 8-15 hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



ACTIVE RBS 

identifies the next lines as the 
contents of the active RBs queued to 
the TCB. 

cccc hhhhhh 

indicates the RB type and its starting 
address. 

The RB types are: 

PRB Program request block 

SIRB Supervisor interrupt request 
block 

LPRB Loaded program request block 

IRB Interruption request block 

SVRB Supervisor request block 



Note : Three SVRBs for ABEND 
processing exist in the nucleus. They 
are used when there is insufficient 
space in the partition to create an 
SVRB. 



NM xxxxxxxx 

is the XRBNM field (bytes through 
7): in PRB, LRB, and LPRB, the 
program name; in IRB, the first byte 
contains flags for the timer or, if 
the timer is not being used, contains 
no meaningful information; in SVRB for 
a type 2 SVC routine, the first 4 
bytes contain the TTR of the load 
module in the SVC library, and the 
last 4 bytes contain the SVC number in 
signed, unpacked decimal. 
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SZ/STAB hhhhhhhh 

contains in the first 4 digits, the 
XRBSZ field (bytes 8 and 9) : number 
of contiguous doublewords in the RB, 
the program (if applicable) , and 
associated supervisor work areas- 
contains in the last 4 digits, the 
XSTAB field (bytes 10 and 11) : flag 
bytes. 

USE/EP hhhhhhhh 

contains, in the first 2 digits, the 
XRBUSE field (byte 12) : use count. 

contains, in the last 6 digits, the 
XRBEP field (bytes 13 through 15): 
address of entry point in the 
associated program. 

PSW hhhhhhhh hhhhhhhh 

is the XRBPSW field (bytes 16 through 
23) ; resume PSW. 

Q hhhhhh 

is the last 3 bytes of the XRBQ field 



(bytes 25 through 27) : in PRB and 
LPRB, starting address of an LPRB for 
an entry identified by an IDENTIFY 
macro instruction; in IRB, starting 
address of a request element; in SVRB 
for a type 3 or 4 SVC, size of the 
program in bytes. 

WT/LNK hhhhhhhh 

contains, in the first 2 digits, the 
XRBWT field (byte 28) : wait count. 

contains, in the last 6 digits, the 
XRBLNK field (bytes 29 through 31) : 
primary queuing field. It is the 
starting address of the previous RB 
for the task or, in the first RB to be 
placed on the queue, the starting 
address of the TCB. 

RG 0-7 and RG 8-15 

is the XRBREB field (bytes 32 through 
95 in IRBs and SVRBs) : contents of 
general registers through 15 stored 
in the RB. These 2 lines do not 
appear for PRBs, LPRBs, and LRBs. 



LOAD LIST 

cccc hhhhhh NH cccccccc SZ/STAB hhhhhhhh USE/EP hhhhhhhh PSW hhhhhhhh hhhhhhhh Q hhhhhh WT/LNK hhhhhhhh 



LOAD LIST 

identifies the next lines as the 
contents of the load list queued to 
the TCB. 



cccc hhhhhh 

indicates the RB type and its starting 
address. 

The RB types are: 

LRB Loaded request block 
LPRB Loaded program request block 
D-LPRB Dummy loaded program request 
block. (Present if the 
resident reenterable load 
module option was selected). 

NM cccccccc 

is the XRBNM field (bytes through 
7) : program name. 

SZ/STAB hhhhhhhh 

contains, in the first 4 digits, the 
XRBSZ field (bytes 8 and 9) : number 
of contiguous doublewords for the RB, 
the program (if applicable), and 
associated supervisor work areas. 



contains, in the last 4 digits, the 
XSTAB field (bytes 10 and 11) : flag 
bytes. 

USE/EP hhhhhhhh 

contains, in the first 2 digits, the 
XRBUSE field (byte 12): use count. 

contains, in the last 6 digits, the 
XRBEP field (bytes 12 through 15): 
address of entry point in the program. 

PSW hhhhhhhh hhhhhhhh 

is the XRBPSW field (bytes 16 through 
23): resume PSW. 

Q hhhhhh 

is the last 3 bytes of the XRBQ field 
(bytes 25 through 27) : in LPRB, 
starting address of an LPRB for an 
entry identified by an IDENTIFY macro 
instruction; in LRB, unused. 

WT/LNK hhhhhhhh 

contains, in the first 2 digits, the 
XRBWT field (byte 28): wait count. 

contains, in the last 6 digits, the 
XRBLNK field (bytes 29 through 31): 
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primary queuing field for LRBs and 
LPRBs also on the active RB queue. It 
points to the previous RB for the task 
or, in the oldest RB in the queue, 
back to the TCB. 



JOB PACK AREA QUEUE 

cccc hhhhhh NM cccccccc 
cccc hhhhhh NM cccccccc 
cccc hhhhhh NM cccccccc 


SZ/STAB 
SZ/STAB 
SZ/STAB 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


USE/EP 

WTL 

USE/EP 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


PSW 

REQ 
PSW 


hhhhhhhh hhhhhhhh Q hhhhhh 
hhhhhhhh TLPRB hhhhhhhh 
hhhhhhhh hhhhhhhh Q hhhhhh 


WT/LNK hhhhhhhh 
WT/LNK hhhhhhhh 



JOB PACK AREA QUEUE (MPT with subtasking 

only) 

identifies the next lines as the 
contents of the job pack area queue 
originating in the partition 
information block (PIB). 

cccc hhhhhh 

indicates the RB type and its starting 
address. 

The RB types are: 

FRB Finch request block 

LRB Loaded request block 

LPRB Loaded program request block 

NM cccccccc 

is the XRBNM field (bytes through 
7) : Program name. 

SZ/STAB hhhhhhhh 

contains, in the first 4 digits, the 
XRBSZ field (bytes 8 and 9) : number 
of contiguous doublewords for the RB, 
the program (if applicable), and 
associated supervisor work areas. 

contains, in the last 4 digits, the 
XSTAB field (bytes 10 and 11): flag 
bytes. 

USE/EP hhhhhhhh (LPRB, LRB Only) 

contains, in the first 2 digits, the 
XRBUSE field (byte 12): use count. 

contains, in the last 6 digits, the 
XRBEP field (bytes 13 through 15): 
address of entry point in the program. 

WTL hhhhhhhh (FRB Only) 

is the XRWTL field of the FRB (bytes 



12 through 15) : address of the most 
recent wait list element (WLE) on the 
WLE queue. 



PSW hhhhhhhh hhhhhhhh (LPRB, LRB Only) 

is the XRBPSW field (bytes 16 through 
23): resume PSW. 



REQ hhhhhhhh (FRB Only) 

is the XRREQ field of the FRB (bytes 
16 through 19): address of the TCB of 
the requesting task. 

TLPRB hhhhhhhh (FRB Only) 

is the XRTLPRB field of the FRB (bytes 
20 through 23) : address of the LPRB 
built by the Finch routine for the 
requested program. 

Q hhhhhh (LRB, LPRB Only) 

is the last 3 bytes of the XRBQ field 
(bytes 25 through 27) : 

• in an LPRB, the starting address of 
an LPRB for an entry identified by 
an IDENTIFY macro instruction. 

• in an LRB, unused. 

WT/LNK hhhhhhhh (LRB, LPRB Only) 

contains, in the first 2 digits, the 
XRBWT field (byte 28) : wait count. 

contains, in the last 6 digits (bytes 
29 through 31) : primary queuing field 
for RBs. These RBs may be queued 
either on the job pack area queue or 
on the active RB queue. It points to 
the previous RB for the task or, in 
the oldest RB on the queue, back to 
the TCB. 
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P/P STORAGE BOUNDARIES hhhhhhhh TO hhhhhhhh 
FREE AREAS SIZE 

hhhhhh hhhhhhhh 
GOTTEN CORE SIZE 

hhhhhh hhhhhhhh 

SAVE AREA TRACE 

ccccccce HAS ENTERED VIA LINK (CALL) ddddd AT EP CCCCC... 



SA 



hhhhhh 



WDl hhhhhhhh 
Rl hhhhhhhh 
R7 hhhhhhhh 



HSA hhhhhhhh 
R2 hhhhhhhh 
RB hhhhhhhh 



LSA hhhhhhhh 
R3 hhhhhhhh 
R9 hhhhhhhh 



RET hhhhhhhh 
R4 hhhhhhhh 
RIO hhhhhhhh 



EPA hhhhhhhh 
R5 hhhhhhhh 
Rll hhhhhhhh 



RO hhhhhhhh 
R6 hhhhhhhh 
R12 hhhhhhhh 



INCORRECT BACK CHAIN 
PROCEEDING BACK VIA REG 13 



P/P STORAGE BOUNDARIES hhhhhhhh TO hhhhhhhh 
gives the addresses of the lower and 
upper boundaries of a main storage 
area assigned to the task. This 
heading is repeated for every 
noncontiguous block of storage owned 
by the task. 

FREE AREAS SIZE 

hhhhhh hhhhhh 



hhhhhh hhhhhh 

are the starting addresses of free 
areas and the size, in bytes, of each 
area contained within the P/P STORAGE 
BOUNDARIES field listed above. 

GOTTEN CORE SIZE 

hhhhhh hhhhhhhh 



hhhhhh hhhhhhhh 

(Printed only in a dump of a system 
with the MFT with subtasking option) . 
These figures represent the starting 
addresses of the gotten areas (those 
areas obtained for a subtask through a 
supervisor issued GETMAIN macro 
instruction), and the size, in bytes, 
of each area contained within the P/P 
STORAGE BOUNDARIES field listed above. 
If main storage hierarchy support is 
included in the system, the values in 
this field can address storage in 
either hierarchy or hierarchy 1, or 
both. 

SAVE AREA TRACE 

identifies the next lines as a trace 
of the save areas for the program. 



ccccccce WAS ENTERED 

is the name of the program that stored 
register contents in the save area. 
This name is obtained from the RB. 



VIA LINK (CALL) ddddd 

indicates the macro instruction (LINK 
or CALL) used to give control to the 
next lower level module, and is the ID 
operand, if it was specified, of the 
LINK or CALL macro instruction. 

AT EP ccccc. . . 

is the entry point identified, which 
appears only if it was specified in 
the SAVE macro instruction that filled 
the save area. 

SA hhhhhh 

is the starting address of the save 
area . 

WDl hhhhhhhh 

is the first word of the save area: 
use of this word is optional. 

HSA hhhhhhhh 

is the second word of the save area: 
starting address of the save area in 
the next higher level module. In the 
first save area in a job step, this 
word contains zeros. In all other 
save areas, this word must be filled. 

LSA hhhhhhhh 

is the third word of the save area 
(register 13) : starting address of 
the save area in the next lower level 
module. 

RET hhhhhhhh 

is the fourth word of the save area 
(register 14): return address. 
Optional. 
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EPA hhhhhhhh 

is the fifth word of the save area 
(register 15) : entry point to the 
invoked nodule. Optional. 

RO hhhhhhhh Rl hhhhhhhh ... R12 hhhhhhhh 
are words 6 through 18 of the save 
area (registers through 12) : 
contents of registers through 12 
immediately after the linkage for the 
module containing the save area. 

INCORRECT BACK CHAIN 

indicates that the following lines may 
not be a save area because the second 



word in this area does not point back 
to the previous save area in the 
chain. 



PROCEEDING BACK VIA REG 13 

indicates that the next 2 save areas 
are (1) the save area in the lowest 
level module, followed by (2) the save 
area in the next higher level module. 
The lowest save area is assumed to be 
the save area pointed to by register 
13. These 2 save areas appear only if 
register 13 points to a full word 
boundary and does not contain zeros. 



DATA SETS 












cccccccc UCB ddd hhhhhh 


DEB hhhhhh 


DCB hhhhhh 


••D/S FORMATTING TERMINATED** 







DATA SETS 

indicates that the next lines present 
information about the data sets for 
the task. For unopened data sets, 
only the ddname and UCB information 
are printed. 

NOT FORMATTED 

indicates that the abnormal 
termination dump routine confiscated 
storage (indicated by *CORE NOT 
AVAILABLE, LOC. hhhhhh-hhhhhh TAKEN); 
because DCBs may have been overlaid, 
or that the dump is for an OLTEP task. 
Data set information is not presented. 

cccccccc 

is the name field (ddname) of the DD 
statement. 

UCB ddd hhhhhh 

is the unit to which the data set was 



assigned, and the starting address of 
the UCB for that unit. If the data 
set was assigned to several units, the 
additional units are identified on 
following lines. 



DEB hhhhhh 

is the starting address of the DEB for 
the data set. Appears only for open 
data sets . 

DCB hhhhhh 

is the starting address of the DCB for 
the data set. Appears only for open 
data sets . 

**D/S FORMATTING TERMINATED** 

indicates that no more data set 
information is presented because a DCB 
is incorrect, possibly because a 
program incorrectly modified it. 
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TRACE 


TABLE - STARTING WITH OLDEST 


ENTRY 






















dddd 
dddd 
dddd 


I/O 
SIO 
SVC 


ddd 
ddd 
ddd 


PSW 
CC ■ 
PSW 


hhhhhhhh 

d 

hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


CAW 
RG 


hhhhhhhh 
hhhhhhhh 


CSW 
OLD 
RG 1 


CSW 


hhhhhhhh 
hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


(or 


CSW 


STATUS 


hhhh) 



TRACE TABLE — STARTING WITH OLDEST ENTRY 
identifies the next lines as the 
contents of the trace table. Each 
entry is presented on one line. The 
types of entries are: 



I/O Input/output interruption entry 



SIO Start input/output (SIO) entry 

SVC supervisor call (SVC) interruption 
entry 



dddd 



is the number assigned to each entry. 
The oldest entry receives the number 
0001. 



CC=d 

is the condition code resulting from 
execution of the SIO instruction. 
Zero indicates a successful start. 

CAW hhhhhhhh 

is the channel address word used by 
the SIO instruction. 

OLD CSW hhhhhhhh hhhhhhhh 

is the channel status word stored 
during execution of an SIO operation. 
It appears when CC is not equal to 1. 

CSW STATOS hhhh 

is the status portion of the channel 
status word stored during execution of 
an SIO instruction. Appears when CC 
is equal to 1. 



I/O ddd 

is the channel and unit that caused 
the input/output interruption. 



SVC ddd 

is the SVC instructions operand. 



PSW hhhhhhhh hhhhhhhh 

is the program status word that was 
stored when the input/output 
interruption occurred. 

CSW hhhhhhi.h hhhhhhhh 

is the channel status word that was 
stored when the input/output 
interruption occurred. 

SIO ddd 

is the device specified in the SIO 
instruction. 



PSW hhhhhhhh hhhhhhhh 

is the PSW stored during the SVC 
interruption. An F in the fifth digit 
of the first word identifies the entry 
as representing a task switch. 



RG hhhhhhhh 

is the contents of register 
passed to the SVC routine. 



as 



RG 1 hhhhhhhh 

is the contents of register 1 as 
passed to the SVC routine. 
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REGS 


AT ENTRY 


TO 


ABEND (SNAP) 








FLTR 


0-6 




hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh 


REGS 


0-7 




hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


REGS 


8-15 




hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 



REGS AT ENTRY TO ABEND or REGS AT ENTRY TO 



SNAP 



identifies the next 3 lines as the 
contents of the floating point and 
general registers when the abnormal 
termination routine received control 
in response to an ABEND macro 
instruction or when the SNAP routine 
received control in response to a SNAP 
macro instruction. 



FLTR 0-6 



is the contents of floating point 
registers 0, 2, U, and 6. 



REGS 0-7 



is the contents of general registers 
through 7. 



REGS 8-15 



is the contents of general registers 8 
through 15. 



NUCLEUS 

hhhhhh 
hhhhhh 

LINE 
hhhhhh 

LINES 
hhhhhh 
P/P STORAGE 



hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhh SAME AS ABOVE 

hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 

hhhhhh-hhhhhh SAME AS above 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



hhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 

LINES hhhhhh-hhhhhh SAME AS ABOVE 
hhhhhh hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
END OF DUMP 



hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



•cccccocccccccccccccccccccccccccc* 
•cccccccccccccccccccccccccccccccc* 



*cccccccccccccccccccccccccccccccc* 
•cccccccccccccccccccccccccccccccc* 



*cccccccccccccccccccccccccccccccc* 
•cccccccccccccccccccccccccccccccc* 
•cccccccccccccccccccccccccccccccc* 



hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh *cccccccccccccccccccccccccccccccc* 



The content of main storage is given 
under 2 headings: NUCLEUS and P/P STORAGE. 
Under these headings y the lines have the 
following format: 

• First entry: the address of the 
initial byte of main storage contents 
presented on the line. 

• Next 8 entries: 8 full words (32 
bytes) of main storage in hexadecimal. 

• Last entry (surrounded by asterisks): 
the same 8 full words of main storage 
in EBCDIC. Only A through Z, through 
9, and blanks are printed; a period is 
printed for anything else. An 
exception occurs in the printed lines 
representing the ABDUMP work area. The 
contents of the ABDUMP work area during 
the printing of EBCDIC characters 



differs from the contents during 
printing of the hexadecimal characters 
because a portion of the work area is 
used to write lines to the printer. 
This exception should not create any 
problems since the contents of the 
ABDUMP work area is of little use in 
debugging. 

The following lines may also appear: 

LINES hhhhhhhh -hhhhhhhh SAME AS ABOVE 
are the starting addresses of the 
first and last line of a group of 
lines that are identical to the line 
immediately preceding. 

LINE hhhhhh SAME AS ABOVE 

is the starting address of a line that 
is identical to the line immediately 
preceding. 
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NUCLEUS 

identifies the next lines as the 
contents of the control program 
nucleus, 

P/P STORAGE 

identifies the next lines as the 
contents of the main storage area 
assigned to the task (problem 
program) . 

END OF DUMP 

indicates that the dump or snapshot is 
completed. 



Load List and Job Pack Area Queue : The 
load module that had control at the time of 
abnormal termination may not contain the 
instruction address pointed to by the 
resume PSW. In that case, look at the RBs 
on the load list and on the job pack area 
queue (MFT with subtasking). Compare the 
instruction address with the entry points 
of each load module (shown in the last 3 
bytes of the field labeled USE/EP) . The 
module which contains the instruction 
pointed to by the resume PSW is the one in 
which abnormal termination occurred. The 
name of the load module is indicated in the 
field labeled NM. 



Guide to Using an ABEND/SNAP Dump (MFT) 



Cause of Abnormal Termination : Evaluate 
the user (USER Decimal code) or system 
(SYSTEM=hex code) completion code using 
Appendix C or the publication Messages and 
Codes . 



Active RB Queue : The first RB shown on the 
dump represents the oldest RB on the queue. 
The RB representing the load module that 
had control when the dump was taken is 
third from the bottom. The last RB 
represents the ABDUMP routine, and the 
second from last, the ABEND routine. The 
names of load modules represented in the 
active RB queue are given in the RB field 
labeled NM in the dump. Names of load 
modules in SVC routines are presented in 
the format: 



NM 



SVC-mnnn 



where m is the load module number (minus 1) 
in the routine and nnn is the signed 
decimal SVC number. The last two RBs on an 
ABEND/ SNAP dump will always be SVRBs with 
edited names SVC-105A (ABDUMP — SVC 51) and 



SVC-401C (ABEND— SVC 13) 



Resume PSW : The resume PSW field is the 
fourth entry in the first line of each RB 
printout. It is identified by the 
subheading PSW. For debugging purposes, 
the resume PSW of the third RB from the 
bottom, on the dump, is most useful. The 
last three characters of the first word 
give the SVC number or the I/O device 
address , depending on which type of 
interruption caused the associated routine 
to lose control. It also provides the CPU 
state at the time of the interruption (bit 
15), the length of the last instruction 
executed in the program (bits 32,33), and 
the address of the next instruction to be 
executed (bytes 5-8). 



Trace Table : Entries in the trace table 
reflect SIO, I/O, and SVC interruptions and 
task switching. SIO entries can be used to 
locate the CCW (through the CAW) , which 
reflects the operation initiated by an SIO 
instruction. If the SIO operation was not 
successful, the CSW STATUS portion of the 
entry will show you why it failed. 

I/O entries reflect the I/O old PSW and 
the CSW that was stored when the 
interruption occurred. From the PSW, you 
can learn the address of the device on 
which the interruption occurred (bytes 2 
and 3) , the CPU state at the time of 
interruption (bit 15) , and the instruction 
address where the interruption occurred 
(bytes 5-8). The CSW provides you with the 
unit status (byte 4) , the channel status 
(byte 5), and the address of the previous 
CCW plus 8 (bytes 0-3). 

SVC entries provide the SVC old PSW and 
the contents of registers and 1. The PSW 
offers you the hexadecimal SVC number (bits 
20-31), the CPU mode (bit 15), and the 
address of the SVC instruction (bytes 5-8). 
The contents of registers and 1 are 
useful in that many system macro 
instructions use these registers for 
parameter information. Contents of 
registers and 1 for each SVC interruption 
are given in Appendix A. 

A task switch entry is similar to an SVC 
entry, except that words 3 and 4 of the 
entry contain the address of the TCBs for 
the "new" and "old" tasks being performed, 
respectively. The trace table entries for 
one particular task are contained between 
sets of two task switch entries. Word 3 of 
the beginning task switch entry and word 4 
of the ending task switch entry point to 
the TCB for that task. Task switch entries 
are identified by a fifth digit of ' F*. 

Notes : If an ABEND macro instruction is 
issued by the system when a program check 
interruption causes abnormal termination, 
an SVC entry does not appear in the trace 
table, but is reflected in the PSW at entry 
to ABEND. 
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Dumps issued by systems with MFT contain Free Areas ; ABEND/SNAP dumps do not print 

only the last four characters of the module out areas of main storage that are 

name in the RB APSW field. You cannot available for allocation. Since the ABEND 

distinguish between IFGOxxxx and IGGOxxxx. routine uses some available main storage. 

After an SVC 19 has been issued, the OPEN the only way you can determine the amount 

where-to-go table should be checked for the of free storage available when abnormal 

module name. termination occurred is to re-create the 

situation and take a stand-alone dump. 
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ABEND/SNAP Dump (MVT) 



MVT dumps differ from PCP and MFT dumps in 
the addition of detailed main storage 
control information, the omission of a 
complete main storage dump, and the 
omission of a trace table in ABEND dumps. 
MVT dumps occur immediately after an 
abnormal termination, provided an ABEND or 
SNAP macro instruction was issued and 
proper dump data sets were defined. 
However, if a system failure has occurred 
and a SYS1.DUMP data set has been defined 
and is available, a full storage image dump 
is provided, as explained in the section 
headed "Storage Image Dump. " 



With MVT's subtask creating capability, 
you may receive one or more partial dumps 
in addition to a complete dump of the task 
that caused abnormal termination. A 
complete dump includes all control 
information associated with the terminating 
task and a printout of the load modules and 
subpools used by the task. A partial dump 
of a task related to the terminating task 
includes only control information. A 
partial dump is identified by either ID=001 
or ID=002 printed in the first line of the 
dump;. Figure 18 shows the key areas of a 
complete dump. 



In systems with MVT, you can effect 
termination of a job step task upon 
abnormal termination of a lower level task. 
To do this, you must either terminate each 
task upon finding an abnormal termination 
completion code issued by its subtask or 
pass the completion code on to the next 
higher level task. 

For a discussion of a formatted ABEND 
dump using the telecommunications access 
method (TCAM) in an MVT environment, see 
IBM System/360 Operating System; TCAM 
Program Logic Manual , GY30-2029. 
References to other TCAM debugging aids are 
found in Appendix J. 



Invoking an ABEND/SNAP Dump (MVT) 

ABEND/ SNAP dumps issued by systems with MVT 
are invoked in the same manner as those 
under systems with PCP and MFT. They 
result from an ABEND or SNAP macro 
instruction in a system or user program, 
accompanied by a properly defined data set. 
In the case of a system failure, the damage 
assessment routine (DAR) attempts to write 
a storage image dump to the SYS1.DUMP data 
set. A full explanation of storage image 
dumps may be found in the section headed 
"Storage Image Dump." The instructions 
that invoke an ABEND/SNAP dump in MVT 



environment are the same as those given in 
the preceding topic for systems with MFT. 
However, some additional considerations 
must be made in requesting main storage and 
direct access space. 

MVT Considerations ; In specifying a region 
size for a job step subject to abnormal 
termination, you must consider the space 
requirements for opening a SYSABEND or 
SYSUDUMP data set (if there is one) , and 
loading the ABDUMP routine and required 
data management routines. This space 
requirement can run as high as 6000 bytes. 

Direct access devices are used 
frequently for intermediate storage of dump 
data sets in systems with MVT. To use 
direct access space efficiently, the space 
for the dump data set should be varied, 
depending on whether or not abnormal 
termination is likely. A small quantity 
should be requested if normal termination 
is expected. To prevent termination of the 
dump due to a lack of direct access space, 
always specify an incremental (secondary) 
quantity when coding a SPACE parameter for 
a dump data set. You can obtain a 
reasonable estimate of the direct access 
space required for an ABEND/ SNAP dump by 
adding, (1) the number of bytes in the 
nucleus, (2) the part of the system queue 
space required by the task (9150 bytes is a 
sufficient estimate) , and (3) the amount of 
region space occupied by the task. 
Multiply the sum by 4 , and request this 
amount of space in 1024-byte blocks. 



This formula gives the space 
requirements for one task. Request 
additional space if partial dumps of 
subtasks and invoking tasks will be 
included. 



Contents of an ABEND/SNAP Dump (MVT) 

This explanation of the contents of 
ABEND/SNAP dumps issued by systems with MVT 
is interspersed with sample sections from 
an ABEND dump. Capital letters represent 
the headings found in all dumps, and 
lowercase letters, information that varies 
with each dump. The lowercase letter used 
indicates the mode of the information and 
the number of letters indicates its length; 

• h represents 1/2 byte of hexadecimal 
information 

• d represents 1 byte of decimal 
information 

• c represents a 1-byte character 

You may prefer to follcw the explanation on 
your own ABEND or SNAP dump. 
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JOB I PCTA1 STFP FXSTFP 

COMPLETION CfllE SYSTFM « B37 

PSW AT FNTRY TO ABFNO FF0*000O 5000C*OR 



TTMF 007*09 P»TF 99366 



TCB 07F028 


»BP 


00O7ECT8 




MSS 


oio3i73« 




FSA 


01060768 




LTC 


nooooooo 




NSTAF 


oooooooo 


ACTIVF RBS 






PRB 0300F8 


RFSV 


00000000 




O/TTR 


00000000 


MB 03O9B8 


RFSV 


00000000 




O/TTR 


00000000 


SVRB 02FOFO 


TAP-IN 00980*00 



PIF 00000000 

PK-FIG F0B50*09 
TCB 00000000 

I OF 00000000 

TfT 00030268 



APSW OOOOOOOO 
WT-INK 0007F07B 



APSW OOOOOOOO 
WT-INK 000300F8 



OER 0007FO3* 

FIG OOOOOOOO 

TME OOOOOOOO 

FCB 00030*8* 

USE* OOOOOOOO 



Tin 000302FO 
US 000309BO 
JST 0002F078 
STA OOOOOOOO 
OAR OOOOOOOO 



CMP BOB3T000 
JIB OOOOOOOO 
NTC OOOOOOOO 
D-PQF 00032668 
RFSV OOOOOOOO 



TUN OOOOOOOO 

JPO 00030IE8 

OTC 00030908 

SOS 0007EAAO 

JSCB 0003I*6C 



-SZ-STAR 000*0082 FL-CDE 00031790 PSW FFF50006 7003533E 



WC-SZ-STAB 000*0002 Fl-COF 00030E80 PSW FFF50037 570TECAA 



APSW F5«=5F0F? WC-SZ-STAB 0OI2O0O2 
O/TTR 00003C0F WT-INK 000109R8 

Rfi 0-7 0O000F09 000396F* 00000003 00000006 

RG 8-15 00039100 000396F* 000606:0 0003A158 

FXTSA E7ERE7F5 F3n6C3*0 000600EO 0002FFF* 

800026*8 00000001 00060FEO C3C*5O0* 

SVRB 02F1T0 TAB-IN 00R803C8 APSW F7F0F1C3 WC-SZ-STAB OO17OO0? 
O/TTR 00006109 WT-INK 0007F0E0 

RG 0-7 80000000 80B37000 000396F* *000C182 

R3 B-I5 00000837 0003036C 800026*8 00000001 

FXTSA 000029BF 00060088 2000FFFF 00060BF0 

C5C1F0F1 C9C5C178 CIC7C505 C*078386 

SVRB 07Fr.78 TAR-IN OnrR03r.A APSW F1F0FV.1 WC-SZ-STAB 00120007 

O/TTR 00006701 WT-LNK 0007F170 

SG 0-7 OOOOOOOO 0002F100 8O00B0CB 0000DB6B 

■»:. 8-15 0007F078 *O00BO3A OOO7F078 0O06OO88 

FXTSA 00620300 000900*0 0008000A 1R0026*8 

0017C302 OOOOOOOO OOOOOOOO OOOOOOOO 



PSW FFO*OO0D 5000C*08 



00000073 0003BCOO 

0003ACF1 000395C0 

0007FFC* 00060FB8 



00036F88 0003CC33 

5207F*3* OOOTECIO 

0000083T 0003036C 



PSW 000*0033 5000COCF. 



000600FO 0002EFD* 

00060FFO 000026*8 

FF030000 0007F1FC 



0002EFC* 00060FB8 

0000DB68 00000001 

0002FIF* F2E8F2C9 



PSW FFO*0001 *007F8A* 



0002FO78 0002F170 

00030320 ooo?riF* 

000000*0 000900*1 



00031290 OOOOOOOO 

♦000059* OOOOOOOO 

00028*60 00000018 



NF 00O30BF8 RSP-COF 070301F8 
NF 00031080 RSP-COF 01032260 
NE 000311C0 RSP-OE 010323C0 



NE 00030DFO ASP-CDF 01032390 
NF 000310C8 RSP-COF 01032390 
NF OOOOOOOO RSP-COE 01030BF0 



NE 00031078 
NE 00031170 



RSP-COE 0I0922M 
RSP-CDE 01032200 



031290 


ATRI 


08 


NCOF 


000000 


ROC-RB 


00030DF8 


NM 


GO 


USE 


01 


EPA 


035508 


ATR2 


20 


XL/MJ 


0312M 


030ES0 


ATR1 


OB 


NCOE 


031290 


ROC-RB 
ROC-RB" 


0O0309B8 
"OOOOOOOO 


NM 


IEKAAOO 


USE 


01 


EPA 


0362*0 


ATR2 


20 


XL/MJ 


02F39I 


0301F8 


ATRI 


31 


NCOF 


030BF0 


NM 


1GC0AQ5A 


USE 


02 


EPA 


06C980 


ATR2 


78 


XI /MJ 


030AB0 


032390 


ATRI 


B8 


NCOE 


0323C0 


ROC-PB 


00030000 


NM 


IGG019CD 


USE 


06 


EPA 


OTEAOO 


ATR2 


20 


Xl/MJ 


032380 


032290 


ATRI 


BR 


Nf.OE 


0322C0 


ROC-RB 


OOOOOOOO 


NM 


I6G019BA 


USE 


05 


EPA 


07E*A0 


ATR2 


20 


Xl/MJ 


032280 


032260 


ATRI 


B8 


NCOE 


032290 


ROC-RB 


OOOOOOOO 


NM 


IGG019BB 


USE 


05 


EPA 


07E880 


ATR2 


20 


XL/MJ 


032250 


032390 


ATRI 


R8 


NCOE 


0323C0 


ROC-RB 


OOOOOOOO 


NM 


1GG0I9C0 


USE 


06 


EPA 


OTEAOO 


ATR2 


20 


Xl/MJ 


032380 


037200 


ATRI 


B8 


NCOF 


032230 


ROC-RB 


OOOOOOOO 


NM 


IGG0I9AJ 


USE 


03 


EPA 


07E3AO 


ATR2 


20 


Xl/MJ 


0321F0 


0323C0 


ATRI 


B8 


NCOF 


0373F0 


ROC-RB 


OOOOOOOO 


NM 


IGG019AR 


USF 


0* 


EPA 


07FC10 


ATR2 


20 


Xl/MJ 


0323B0 


O303F0 


ATRI 


39 


NCOE 


030FR0 


ROC-RB 


OOOOOOOO 


NM 


IEWSZOVR 


USE 


01 


EPA 


06C*B0 


ATR2 


20 


Xl/MJ 


030B88 



031280 


sz 


00000010 


NO 


00000001 


800007F8 


00035508 










02F398 


sz 


oooooo*c 


NO 


00000001 


800I6E38 


000359CB 


000359C8 


00030B00 


OIOAO*00 


01000900 












onr.0300 


01100300 


011E0200 


01290*00 


012E0500 


01300500 












01320300 


013A0100 


01*60600 


01*80*00 


01*00300 




03OAB0 


sz 


oooooo to 


NO 


0000000 1 


R0000680 


0006C980 










0373R0 


sz 


00000010 


NO 


ooooooot 


80000210 


OOOTFAOO 










037780 


sz 


00000010 


NO 


00000001 


80000180 


0007F*AO 










037750 


sz 


00000010 


NO 


00000001 


80000038 


0007F880 










037380 


sz 


00000010 


NO 


00000001 


60000210 


OOOTFAOO 










0321F0 


sz 


00000010 


NO 


ooooooot 


80000100 


0O07E3A0 










0323B0 


sz 


00000010 


NO 


00000001 


80000090 


0007EC10 










030B88 


sz 


00000010 


NO 


00000001 


.80000350 


0006CAB0 











OFB 



O7FO00 

02E020 00000050 OOOOOOOO 0OO3020A 00007BEO 

02FDA0 8F000O00 01000000 OOOOOOOO FF060088 

02F060 0001000B 00010001 C7C7C2C1 C3C*0000 



00000050 00000050 00000050 00000050 
0F003000 0007F028 0*02EE0* 98000000 
0402ED10 180026*8 00000031 00010032 
00003000 OOOOOOOO OOOOOOOO C3C*0000 



• BBBACO. 



Figure 18. Sample of Complete ABEND Dump (MVT) (Part 1 of 2) 
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Figure 18. Sample of Complete ABEND Dump (MVT) (Part 2 of 2) 
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Page of GC28-6670-5, 6, Revised April 16, 1973, By TNL: GN28-25U5 



JOB CCCCCCCC STEP CCCCCCCC TIME dddddd 


DATE ddddd 


ID 


- ddd 


PAGE dddd 


CQMPIETION CODE SYSTEM - hhh (or USER » dddd) 










PSW AT ENTRY TO ABEND (SNAP) hhhhhhhh hhhhhhhh 











JOB CCCCCCCC 

is the job name specified in the JOB 
statement. 

STEP CCCCCCCC 

is the step name specified in the EXEC 
statement for the problem program 
associated with the task being dumped. 

TIME dddddd 

is the hour {first 2 digits) , minute 
(next 2 digits), and second (last 2 
digits) when the abnormal termination 
dump routine began processing. 

DATE ddddd 

is the year (first 2 digits) and day 
of the year (last 3 digits). For 
example, 67352 would be December 18, 
1967. 

ID=ddd 

is an identification of the dump. For 
dumps requested by an ABEND macro 
instruction, this identification is: 

• Absent if the dump is of the task 
being abnormally terminated. 

• 001 if the dump is of a subtask of 
the task being abnormally 
terminated. (Note that, when a task 
is abnormally terminated, its 

sub tasks are also abnormally 
terminated.) 

• 002 if the dump is of a task that 
directly or indirectly created the 



task being abnormally terminated, up 
to and including the job step task. 



PAGE dddd 

is the page number. Appears at the 
top of each page. Page numbers begin 
at 0001 for each task or subtask 
dumped. 

COMPLETION CODE SYSTEM=hhh or COMPLETION 

CODE USER=dddd 

is the completion code supplied by the 
control program (SYSTEM=hhh) or the 
problem program (USER=dddd). 
For a system completion code of 0C0, 
denoting an imprecise interruption on 
a Model 91 or Model 195, bits 20 
through 29 of the CMP field of the TCB 
are significant for a Model 91, while 
all the bits (20 through 31) are used 
by a Model 195. For further 
discussion on interpreting the 
imprecise interruption configuration 
refer to the publication IBM 
System/360 Operating 
System: Supervisor Services , Order 
No. GC28-6646. 

PSW AT ENTRY TO ABEND hhhhhhhh hhhhhhhh or 
PSW AT ENTRY TO SNAP hhhhhhhh hhhhhhhh 

is the PSW for the problem program or 
control program routine that had 
control when abnormal termination was 
requested, or when the SNAP macro 
instruction was executed. It is not 
necessarily the PSW at the time the 
error condition occurred. 
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Page of GC28-6670- 5 f 6, Revised April 16, 1973, By TNL: GN28-2545 



TCD hhhhhh RBP hhhhhhhh PIE 


hhhhhhhh 


DEB hhhhhhhh TIO hhhhhhhh CMP 


hhhhhhhh 


TRN hhhhhhhh 


MSS hhhhhhhh PK-FLO hhhhhhhh 


PLG hhhhhhhh LL.S hhhhhhhh JI,B 


hhhhhhhh 


,IPQ hhhhhhhh 


RG 0-7 hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


RG 8-15 hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


FSA hhhhhhhh TCB 


hhhhhhhh 


THE hhhhhhhh ,)ST hhhhhhhh NTC 


hhhhhhhh 


OTC hhhhhhhh 


LTC hhhhhhhh IQE 


hhhhhhhh 


ECB hhhhhhhh STA hhhhhhhh D-PQE 


hhhhhhhh 


SQS hhhhhhhh 


NSTAE hhhhhhhh TCT 


hhhhhhhh 


USER hhhhhhhh DAR hhhhhhhh RESV 


hhhhhhhh 


JSCB hhhhhhhh 



TCB hhhhhh 

is the starting address of the TCB. 

RBP hhhhhhhh 

is the TCBRBP field (bytes through 
3): starting address of the active RB 
queue and, consequently, the most 
recent RB on the queue. 



PIE hhhhhhhh 

is the TCBPIE field (bytes 4 through 
7) : starting address of the program 
interruption element (PIE) for the 
task; however, in an abnormal 
termination dump for the task causing 
the abnormal termination, zeros. The 
field is zeroed by the ABEND routine 
to prevent interruptions during 
dumping. 

DEB hhhhhhhh 

is the TCBDEB field (bytes 8 through 
11): starting address of the DEB 
queue. Under the heading DEB in the 
dump, the prefix section for the first 
DEB in the queue is presented in the 
first 8-digit entry on the first line. 
The 6- digit entry at the left of each 
line under DEB is the address of the 
second column on the line, whether or 
not the column is filled. The 
contents of the TCBDEB field may 
differ in the main storage printout 
from what appears in the TCBDEB field 
of the formatted section. This occurs 
when the number of extents specified 
in the DEB for the dump data set is 
not sufficient to complete ABDUMP 
processing. When the dump of main 
storage is given, the END OF VOLUME 
routine may have built another DEB 
having additional extents for the dump 
data set and dequeued the original 
DEB. Therefore, the TCBDEB field in 
the main storage printout may contain 
the address of the new DEB built by 
END OF VOLUME. 

TIO hhhhhhhh 

is the TCBTIO field (bytes 12 through 
15) : starting address of the TIOT. 



CMP hhhhhhhh 

is the TCBCMP field (bytes 16 through 
19): task completion code or contents 
of register 1 when the dump was 
requested. System codes are given in 
the third through fifth digits and 
user codes in the sixth through eight 
digits. 

For a system completion code of 0C0, 
denoting an imprecise interruption on 
a Model 91 or Model 195, digits six 
through eight contain the imprecise 
interruption configuration. These bit 
settings represent bits 16 to 27 of 
the program old PSW (location X*28') 
at the time of the program exception. 
Therefore, in the TCB CMP field, bits 
20 to 29 are significant for a Model 
91 while a Model 195 makes use of all 
the bits (20 to 31). For further 
discussion on interpreting the 
imprecise interruption configuration 
refer to the publication IBM 
System/360 Operating System: 
Supervisor Services . Order 
No. GC28-6646. 

TRN hhhhhhhh 

is the TCBTRN field (bytes 20 through 
23): starting address of the control 
core (table) for controlling testing 
of the task by TESTRAN. 

MSS hhhhhhhh 

is the TCBMSS field (bytes 24 through 
27) : starting address of SPQE most 
recently added to the SPQE queue. 

PK-FLG hhhhhhhh 

contains, in the first 2 digits, the 
TCBPKF field (byte 28) : protection 
key. 

contains, in the last 6 digits, the 
first 3 bytes of the TCBFLGS field 
(bytes 29 through 31): first 3 flag 
bytes. 



FLG hhhhhhhh 

contains, in the first 4 digits, the 
last 2 bytes of the TCBFLGS (bytes 32 
and 33) : last 2 flag bytes. 
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contains, in the next 2 digits, the 

TCBLMP field (byte 34): limit 
priority (converted to an internal 
priority, to 255). 

contains, in the last 2 digits, the 
TCBDSP field (byte 35): dispatching 
priority (converted to an internal 
priority, to 255). 

LIS hhhhhhhh 

is the TCBLLS field (bytes 36 through 
39): starting address of the load 
list element most recently added to 
the load list. 

JLB hhhhhhhh 

is the TCBJLB field (bytes 4 through 
43) : starting address of the DCB for 
the JOBLIB data set. 



RG 0-7 and RG 8-15 

is the TCBGRS field (bytes 48 through 
111) : contents of general registers 
through 7 and 8 through 15, as stored 
in the save area of the TCB when a 
task switch occurred. These 2 lines 
appear only in dumps of tasks other 
than the task in control when the dump 
was requested. 

FSA hhhhhhhh 

contains, in the first 2 digits, the 
TCBQEL field (byte 112): count of 
enqueue elements. 

contains, in the last 6 digits, the 
TCBFSA field (bytes 113 through 115); 
starting address of the first problem 
program save area. This save area was 
set up by the control program when the 
job step was initiated. 



JPQ hhhhhhhh 

is the TCBJPQ field (bytes 41 through 
47) : when translated into binary 
bits: 

• Bit is the purge flag. 

• Bits 1 through 7 are reserved for 
future use and are zeros. 

• Bits 8 through 31 are the starting 
address of the queue of CDEs for the 
job pack area control queue, which 
is for programs acquired by the job 
step. 

The TCBJPQ field is used only in the 
first TCB in the job step; it is zeros 
for all other TCBs. 



TCB hhhhhhhh 

is the TCBTCB field (bytes 116 through 
119) : starting address of the next 
lower priority TCB on the TCB queue 
or, if this is the lowest priority 
TCB, zeros. 
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TME hhhhhhhh 

is the TCBTME field (bytes 120 through 
123): starting address of the timer 
element created when an STIMER macro 
instruction is issued by the task. 



D-PQE hhhhhhhh 

is the TCBPQE field (bytes 152 through 
155) : starting address minus 8 bytes 
of the dummy PQE. This field is 
passed by the ATTACH macro instruction 
to each TCB in a job step. 



JST hhhhhhhh 

is the TCBJSTCB field (bytes 124 
through 127) : starting address of the 
TCB for the job step task. For tasks 
with a protection key of zero, this 
field contains the starting address of 
the TCB. 

NTC hhhhhhhh 

is the TCBNTC field (bytes 128 through 
131) : the starting address of the TCB 
for the previous subtask on this 
subtask queue. This field is zero in 
the job step task, and in the TCB for 
the first subtask created by a parent 
task. 

OTC hhhhhhhh 

is the TCBOTC field (bytes 132 through 
135)s starting address of TCB for the 
parent task. In the TCB for the job 
step task, this field contains the 
address of the initiator. 



LTC hhhhhhhh 

is the TCBLTC field (bytes 136 through 
139) i starting address of the TCB for 
the most recent subtask created by 
this task. This field is zero in the 
TCB for the last subtask of a job 
step, or in a TCB for a task that does 
not create subtasks. 



SQS hhhhhhhh 

is the TCBAQE field (bytes 156 through 
159) : starting address of the 
allocation queue element (AQE) . 



NSTAE hhhhhhhh 

contains, in the first 2 digits, STAE 
flags (byte 160). 



contains, in the last 6 digits, the 
TCBNSTAE field (bytes 161 through 
163): starting address of the current 
STAE control block for the task. This 
field is zero if STAE has not been 
issued. 



TCT hhhhhhhh 

is the TCBTCT field (bytes 16 4 through 
167) : address of the Timing Control 
Table (TCT) . 



USER hhhhhhhh 

is the TCBUSER field (bytes 168 
through 171) : to be used as the user 
chooses. 



IQE hhhhhhhh 

is the TCBIQE field (bytes 140 through 
143) : starting address of the 
interruption queue element (IQE) for 
the ETXR exit routine. This routine 
is specified by the ETXR operand of 
the ATTACH macro instruction that 
created the TCB being dumped. The 
routine is to be entered when the task 
terminates. 



DAR hhhhhhhh 

contains, in the first two digits. 
Damage Assessment Routine (DAR) flags 
(byte 172). 



RESV hhhhhhhh 

reserved for future use. 



ECB hhhhhhhh 

is the TCBECB field (bytes 144 through 
147) : starting address of the ECB to 
be posted by the control program at 
task termination. This field is zero 
if the task was attached without an 
ECB operand. 

TSF hhhhhhhh 

is the TCBSFLG field (bytes 94 through 
97). The first two digits, byte 94, 
contain internal TSO flags, the next 
two digits, byte 95, contain the stop 
count, and the last two bytes, 96 and 
97, contain the limit and dispatching 
priority of the TSO task. 



JSCB hhhhhhhh 

is the TCBJSCB field (bytes 18 
through 183) : the last three bytes 
contain the address of the Job Step 
Control Block. 
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ACTIVE RBS 














cccc hhhhhh 


cccccc hhhhhhhh 
Q/TTR hhhhhhhh 


APSW hhhhhhhh 
WT-LNK hhhhhhhh 


wc-SZ- 


STAB hhhhhhhh 


cccccc hhhhhhhh PSW 


hhhhhhhh hhhhhhhh 




RG 0-7 hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 




RG 8-15 hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 




EXTSA hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh 




hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 







ACTIVE RBS 

identifies the next lines as the 
contents of the active RBs queued to 
the TCB, beginning with the oldest RB 
first. 

cccc hhhhhh 

indicates the RB type (cccc) and 
starting address (hhhhhh) . 

The RB types are: 

PRB program request block 

IRB interruption request block 

SVRB supervisor request block 

cccccc hhhhhhhh 

indicates the RB's function (cccccc) 
and bytes through 3 of the RB 
( hhhhhhhh) : 

• RESV hhhhhhhh indicates PRB or SVRB 
for resident routines. Bytes 
through 3 are reserved for later use 
and contain zeros. 

• TAB-LN hhhhhhhh indicates SVRB for 
transient routines. The first 4 
digits contain the RBTABNO field 
(bytes and 1): displacement from 
the beginning of the transient area 
control table (TACT) to the entry 
for the module represented by the 
RB. The last 4 digits contain the 
RBRTLNTH field (bytes 2 and 3) : 
length of the SVC routine. 

o FL-PSA hhhhhhhh indicates IRB. The 
first 2 digits contain the RBTMFLD 
field (byte 0) : indicators for the 
timer routines. This byte contains 
zeros when the IRB does not 
represent a timer routine. The last 
6 digits contain the RBPSAV field 
(bytes 1 through 3): starting 
address of the problem program 
register save area (PSA) . 



APSW hhhhhhhh 

is the RBABOPSW field (bytes 4 through 
7): 



•In PRB, right half of the problem 
program's PSW when the interruption 
occurred. 

• In IRB or SVRB for type II SVC 
routines, right half of routine's 
PSW during execution of ABEND or 
ABTERM, or zeros. 

• In SVRB for type III or IV SVC 
routines, right half of routine's 
PSW during execution of ABEND or 
ABTERM, or the last four characters 
of the name of the requested 
routine. (The last two characters 
give the SVC number . ) 



WC-SZ-STAB hhhhhhhh 

contains, in the first 2 digits, the 
RBWCSA field (byte 8) : wait count in 
effect at time of abnormal termination 
of the program. 

contains, in the second 2 digits, the 
RBSIZE field (byte 9): size of the RB 
in doublewords. 

contains, in the last 4 digits, the 
RBSTAB field (bytes 10 and 11): 
status and attribute bits- 



cccccc hhhhhhhh 

indicates the RB' s function (cccccc) 
and bytes 12 through 15 of the RB 
(hhhhhhhh): 

• FL-CDE hhhhhhhh indicates SVRB for 
resident routines, or PRB. The 
first 2 digits contain the RBCDFLGS 
field (byte 12): control flags. 
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The last 6 digits contain the RBCDE 
field (bytes 13 through 15) : 
starting address of the CDE for the 
module associated with this RB. 

• EPA hhhhhhhh is the RBEP field of an 
IRB (bytes 12 through 15) : 
entry-point address of 
asynchronously executed routine. 

• TQN hhhhhhhh indicates SVRB for 
transient routines. Is the RBSVTQN 
field (bytes 12 through 15) : 
address of the next RB in the 
transient control queue. 

PSW hhhhhhhh hhhhhhhh 

is the RBOPSW field (bytes 16 through 
23) : resume PSW. 

Q/TTR hhhhhhhh 

• In PRBs and SVRBs for resident 
routines, contains zeros in the 
first 2 digits. The last 6 digits 
contain the RBPGMQ field (bytes 25 
through 27) : queue field for 
serially reusable programs (also 
called the secondary queue) . 

• In IRBs, contains the RBUSE field in 
the first 2 digits (byte 24) : count 
of requests for the same exit 
(ETXR). The RBIQE field in last 6 
digits (bytes 25 through 27) : 
starting address of the queue of 
interruption queue elements (IQE), 
or zeros in the first 4 digits and 
the RBIQE field in the last 4 digits 
(bytes 26 and 27) : starting address 
of the request queue elements. 



In SVRBs for transient routines the 
first 2 digits contain the RBTAWCSA 
field (byte 24) : number of requests 
(used if transient routine is 
overlaid) and the last 6 digits, the 
RBSVTTR field (bytes 25 through 27) : 
relative track address for the SVC 
routine. 



WT-LNK hhhhhhhh 

contains, in the first 2 digits, the 
RBWCF field (byte 28) : wait count. 



contains, in the last 6 digits, the 
RBLINK field (bytes 29 through 31): 
starting address of the previous RB on 
the active RB queue (primary queuing 
field) or, if this is the first or 
only RB, the starting address of the 
TCB. 

RG 0-7 and RG 8-15 

is the RBGRSAVE field (bytes 32 
through 95): in SVRBs and IRBs, 
contents of registers through 15. 



EXTSA 



In IRBs, contains the RBNEXAV field 
in the first 8 digits (bytes 96 
through 99): address of next 
available interruption queue element 
(IQE), and in the remaining digits, 
the interruption queue element work 
space (up to 1948 bytes). 

In SVRBs, contains the RBEXSAVE 
field (bytes 96 through 143) : 
extended save area for SVC routine. 



LOAD LIST 

NE hhhhhhhh RSP-CDE hhhhhhhh 



NE hhhhhhhh RSP-CDE hhhhhhhh 



NE hhhhhhhh RSP-CDE hhhhhhhh 



LOAD LIST 

identifies the next lines as the 
contents of the load list elements 
(LLEs) queued to the TCB by its TCBLLS 
field. The contents of 3 load list 
elements are presented per line until 
all elements in the queue are shown. 

NE hhhhhhhh 

contains, in the first 2 digits, LLE 
byte 0: zeros. 

contains, in the last 6 digits, LLE 
bytes 1 through 3: starting address 
of the next element in the load list. 



RSP-CDE hhhhhhhh 

contains, in the first 2 digits, LLE 
byte 4: the count of the number of 
requests made by LOAD macro 
instructions for the indicated load 
module. This count is decremented by 
DELETE macro instructions. 



contains, in the last 6 digits, LLE 
bytes 5 through 7: starting address 
of the CDE for the load module. 
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hhhhhhhh 



ATRl hh NCDE hhhhhh ROC-RB hhhhhhhh NM cccccccc 



EPA hhhhhh ATR2 hh XL/MJ hhhhhh 



CDE 



identifies the next lines as the 
contents directory addressed by an LLE 
or RB. One entry is presented per 
line. 



hhhhhhhh 

is the starting address of the entry 
given on the line. 

ATRl hh 

is the attribute flags. 

NCDE hhhhhh 

is the starting address of the next 
entry in the contents directory. 

ROC-RB hhhhhhhh 

contains, in the first 2 digits, 
zeros . 

contains, in the last 6 digits, the 
starting address of the RB for the 
load module represented by this entry. 



NM cccccccc 

is the name of the entry point to the 
load module represented by this entry. 



USE hh 

is the count of. the uses (through 
ATTACH, LINK, and XCTL macro 
instructions) of the load module, and 
of the number of LOAD macro 
instructions executed for the module. 

EPA hhhhhh 

is the entry point address associated 
with the name in the NM field. 

ATR2 hh 

is the attribute flags. 

XL/MJ hhhhhh 

is the starting address of the extent 
list (XL) for a major CDE, or the 
starting address cf the major CDE for 
a minor CDE. (Minor CDEs are for 
aliases.) 



hhhhhh SZ hhhhhhhh NO hhhhhhhh 



LN ADR LN ADR 

hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



XL 



indicates the next lines are entries 
in the extent list, which is queued to 
the major contents directory entry. 
Each extent list entry is given in one 
or more lines. Only the first line 
for an entry contains the left 3 
columns; additional lines for an entry 
contain information only in the right 
6 columns. 



hhhhhh 

is the starting address of the entry. 

SZ hhhhhhhh 

is the total length, in bytes, of the 
entry. 



NO hhhhhhhh 

is the number of scattered control 
sections in the lead module described 
by this entry. If this number is 1, 
the load module was loaded as one 
block. 

LN hhhhhhhh 

gives the length, in bytes, of the 
control sections in the load module 
described by this entry. Bit is set 
to 1 in the last, or only, LN field to 
signal the end of the list of lengths. 

ADR hhhhhhhh 

gives the starting addresses of the 
control sections. Each ADR field is 
paired with the LN field to its left. 
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DEB 




















hhhhhh 






hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 




hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 




hhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 


hhhhhhhh 




hhhhhh 


hhhhhhhh 


hhhhhhhh 












TIOT 


JOB 
DD 


CCCCCCCC STEP 
hhhhhhhh 


CCCCCCCC 
CCCCCCCC 


PROC CCCCCCCC 

hhhhhhhh hhhhhhhh 











DEB 



identifies the next lines as the 
contents of the DEBs and their prefix 
sections. The first 6 digits in each 
line give the address of the DEB 
contents shown on the line, beginning 
with the second column. The first six 
digits of the first line contains the 
prefix section for the first DEB on 
the queue. 

Note ; DEBs are not formatted if the 
dump is for an OLTEP task. If a dump 
of the DEB chain is desired, use a 
SYSABEND DD card so that the nucleus 
will be dumped. 



JOB CCCCCCCC 

is the name of the job whose task is 
being dumped. 



STEP cccccccc 

is the name of the step whose task is 
being dumped. 



PROC cccccccc 

is the name for the job step that 
called the cataloged procedure. This 
field appears if the job step whose 
task is being dumped was part of a 
cataloged procedure. 



TIOT 



DD 



identifies the next lines as the 
contents of the TIOT. 



identifies the line as the contents of 
the DD entry in the TIOT. 



MSS 








SPID 


DQE 








LN 


NDQE 


NFQE 


LN 


FLOS 


NSPQE 


BLK 


FQE 




hhhhhh 


hh 


hhhhhh 


ddd 


hhhhhh 




hhhhhh hhhhhh 


hhhhhh 


hhhhhh 


hhhhhhhh 


hhhhhhhh 


D-POE 


hhhhhh 


FIRST 


hhhhhhhh 


LAST 


hhhhhhhh 
















PQE 


hhhhhh 


FFB 
TCB 


hhhhhhhh 
hhhhhhhh 


LFB 
RST 


hhhhhhhh 
hhhhhhhh 


NPO 
RAD 


hhhhhhhh 
hhhhhhhh 


PPO 

FLr 


hhhhhhhh 
hhhhhhhh 








FBQE 


hhhhhh 


NFB 


hhhhhhhh 


PFB 


hhhhhhhh 


SZ 


hhhhhhhh 












PQE 


hhhhhh 


FFB 
TCB 


hhhhhhhh 
hhhhhhhh 


LFB 
RSI 


hhhhhhhh 
hhhhhhhh 


NPfl 
RAD 


hhhhhhhh 
hhhhhhhh 


ppp 
FLr 


hhhhhhhh 
hhhhhhhh 








F8PE 


hhhhhh 


NFB 


hhhhhhhh 


PFB 


hhhhhhhh 


SZ 


hhhhhhhh 













MSS 



hhhhhh 



identifies the next lines as the 
contents of the main storage 
supervisor queue. This queue includes 
subpool queue elements (SPQE) , 
descriptor queue elements (DQE) , and 
free queue elements (FQE). 



SPQE 



is the starting address of the first 
element shown on the line. 



identifies the U columns beneath it as 
the contents of SPQEs. 



ABEND/ SNAP Dump (MVT) 55 



FLGS hh 

is the SPQE flag byte. 

NSPQE hhhhhh 

is the starting address of the next 
SPQE in the queue. 

SPID add 

is the subpool number. 

DQE hhhhhh 

for a subpool owned by the task being 
dumped: the starting address of the 
first DQE for the subpool. 

for a subpool that is shared: the 
starting address of the SPQE for the 
task that owns the subpool. 



DQE 



identifies the 4 columns beneath it as 
the contents of DQEs. 



BLK hhhhhh 

is the starting address of the 
allocated 2K block of main storage or 
set of 2K blocks. 

FQE hhhhhh 

is the starting address of the first 
FQE within the allocated blocks. 

LN hhhhhh 

is the length, in bytes, of the 
allocated blocks- 

NDQE hhhhhh 

is the starting address of the next 
DQE. 



FQE 



identifies the 2 columns beneath it as 
the contents of FQEs. 



NFQE hhhhhhhh 

is the starting address of the next 

FQE. 

LN hhhhhhhh 

indicates the number of bytes in the 
free area. 

D-PQE hhhhhh 

is the TCBPQE field (bytes 152 through 
155) : starting address minus 8 bytes 
of the dummy PQE shown on the line. 

FIRST hhhhhhhh 

is the starting address of the first 

PQE. 

LAST hhhhhhhh 

is the starting address of the last 

PQE. 

PQE hhhhhh 

is the starting address of the PQE 
shown on the line. 



FFB hhhhhhhh 

is bytes through 3 of the PQE: 
starting address of the first FBQE. 
If no FBQEs exist, this field is the 
starting address of this PQE 

LFB hhhhhhhh 

is bytes 4 through 7 of the PQE: 
starting address of the last FBQE- If 
no FBQEs exist, this field is the 
starting address of this PQE. 

NPQ hhhhhhhh 

is bytes 8 through 11 of the element: 
starting address of the next PQE or, 
if this is the last PQE, zeros. 

PPQ hhhhhhhh 

is bytes 12 through 15 of the element: 
starting address of the preceding PQE 
or, if this is the first PQE, zeros. 

TCB hhhhhhhh 

is bytes 16 through 19 of the element: 
starting address of the TCB for the 
job step to which the space belongs 
or, if the space was obtained from 
unassigned free space, zeros. 

RSI hhhhhhhh 

is bytes 20 through 23 of the element: 
size of the region described by this 
PQE (a multiple of 2048). 

RAD hhhhhhhh 

is bytes 24 through 27 of the element: 
starting address of the region 
described by this PQE. 

FLG hhhhhhhh 

is byte 28 of the element : 

bit when 0, indicates space 

described by this PQE is owned; 

when 1, indicates space is 
borrowed . 

bit 1 when 1, indicates region has 

been rolled out (meaningful only 
when bit is 0) . 

bit 2 when 1, indicates region has 
been borrowed. 

bit 3-7, reserved for future use. 



Note : PQE information is contained in two 
lines on the dump. When the rollout/rollin 
feature or Main Storage Hierarchy Support 
is included in the system, PQE information 
(with associated FBQEs) appears once in the 
dump for each region segment of the job 
step. (Each PQE on the partition queue 
defines a region segment. A job step's 
region contains more than one segment only 
when the step has rolled out another step 
or steps, or Main Storage Hierarchy Support 
is present.) 
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FBQE hhhhhh 



PFB hhhhhhhh 



is the starting address of the FBQE 
shown on the line. 



NFB hhhhhhhh 

is bytes through 3 of the element: 
starting address of the next FBQE. In 
the highest or only FBQE, this field 
contains the address of the PQE. 



is bytes 4 through 7 of the element: 
starting address of the previous FBQE, 
In the lowest or only FBQE, the field 
contains the address of the PQE. 



SZ hhhhhhhh 

is bytes 8 through 11 of the element: 
size, in bytes, of the free area. 



QCB TRACE 














MAJ hhhhhh 


NMAJ 


hhhhhhhh 


PMAJ 


hhhhhhhh 


FMIN hhhhhhhh 


NM cccccocc 


MIN hhhhhh 


FQEL 


hhhhhhhh 


PMIN 


hhhhhhhh 


NMIN hhhhhhhh 


NM XX xxxxxxxx 




NQEL 


hhhhhhhh 


PQEL 


hhhhhhhh 


TCB hhhhhhhh 


SVRB hhhhhhhh 



QCB TRACE 

identifies the next lines as a trace 
of the queue control blocks (QCB) 
associated with the job step. Lines 
beginning with MAJ show major QCBs, 
lines beginning with MIN show minor 
QCBs, and lines beginning with NQEL 
show queue elements (QEL). 



MAJ hhhhhh 

is the starting address of the major 
QCB whose contents are given on the 
line. 



NMAJ hhhhhhhh 

is the starting address of the next 
major QCB for the job step. 

PMAJ hhhhhhhh 

is the starting address of the 
previous major QCB for the job step. 

FMIN hhhhhhhh 

is the starting address of the first 
minor QCB associated with the major 
QCB given on the line. 

NM cccccccc 

is the name of the serially reusable 
resource represented by the major QCB. 

MIN hhhhhh 

is the starting address of the minor 
QCB whose contents are given on the 
line. 

FQEL hhhhhhhh 

is the starting address of the first 
queue element (QEL), which represents 
a request to gain access to a serially 
reusable resource or set of resources. 



PMIN hhhhhhhh 

is the starting address of the 
previous minor QCB. 

NMIN hhhhhhhh 

is the starting address of the next 
minor QCB. 

NM xx xxxxxxxx 

indicates, in the first 2 digits, the 
scope of the name or address of the 
minor QCB being dumped. If the scope 
is hexadecimal FF, the name is known 
to the entire operating system. If 
the scope is hexadecimal 00 or 10 
through FO, the name is known only to 
the job step; in this case, the scope 
is the protection key of the TCB 
enqueuing the miner QCB. 

Also contains, in the last 8 digits, 
the name or the starting address of 
the minor QCB. 

NQEL hhhhhhhh 

indicates, by hexadecimal 10 in the 
first 2 digits, that the queue element 
on the line represents a request for 
step-must-complete; by 00, ordinary 
request; and by 20, a 
set-must-complete request. 

Also contains, in the last 6 digits, 
the starting address of the next queue 
element in the queue, or for the last 
queue element in the queue, zeros. 

PQEL hhhhhhhh 

indicates, by hexadecimal 80 in the 
first 2 digits, that the queue element 
represents a shared request or, fcy 
hexadecimal 00, that the element 
represents an exclusive request. (If 



ABEND/SNAP Dump (MVT) 57 



the shared DASD option was selected, 
hexadecimal 10 in the first 2 digits 
indicates an exclusive RESERVE request 
and 00 indicates a shared RESERVE 
request. ) 



TCB hhhhhhhh 

is the starting address of the TCB 
under which the ENQ macro instruction 
was issued. 



SVRB hhhhhhhh 

is the starting address, of the SVRB 
under which the routine for the ENQ 
macro instruction is executed, or, 
after the requesting task receives 
control of the resource, the UCB 
address of a device being reserved 
through a RESERVE macro instruction 
<the latter value occurs only when the 
shared DASD option was selected). 



SAVE AREA TRACE 

cccceccc MAS ENTERED VIA LINK (CALL) ddddd AT EP ccccc... 



SA hhhhhh WDl hhhhhhhh 
Rl hhhhhhhh 
R7 hhhhhhhh 



INCORRECT BACK CHAIN 

INTERRUPT AT hhhhhh 
PROCEEDING BACK VIA REG 13 



HSA hhhhhhhh LSA hhhhhhhh RET hhhhhhhh EPA hhhhhhhh R0 hhhhhhhh 
R2 hhhhhhhh R3 hhhhhhhh R4 hhhhhhhh R5 hhhhhhhh R6 hhhhhhhh 
R8 hhhhhhhh R9 hhhhhhhh RIO hhhhhhhh Rll hhhhhhhh R12 hhhhhhhh 



SAVE AREA TRACE 

identifies the next lines as a trace 
of the save areas for the program. 
Each save area is presented in 3 or U 
lines. The first line gives 
information about the linkage that 
last used the save area. This line 
will not appear when the RB for the 
linkage cannot be found. The second 
line gives the contents of words 
through 5 of the save area. The third 
and fourth lines give the contents of 
words 6 through 18 of the save area; 
these words are the contents of 
registers through 12. Save areas 
are presented in the following order: 

1. The save area pointed to in the 
TCBFSA field of the TCB. This 
save area is the first one for the 
problem program? xt was set up by 
the control program when the job 
step was initiated. 

2. If the third word of the first 
save area was filled by the 
problem program, then the second 
save area shown is that of the 
next lower level module of the 
task. However, if the third word 
of the first area points to a 
location whose second word does 
not point back to the first area, 
the message INCORRECT BACK CHAIN 
appears, followed by possible 
contents of the second save area. 



3. The third, fourth, etc. save 

areas are then shown, provided the 
third word in each higher save 
area was filled and the second 
word of each lower save area 
points back to the next higher 
save area. This process is 
continued until the end of the 
chain is reached (the third word 
in a save area contains zeros) or 
INCORRECT BACK CHAIN appears. 



Following the forward trace, the 
message INTERRUPT AT hhhhhh appears, 
followed by the message PROCEEDING 
BACK VIA REG 13. Then, the save area 
in the lowest level module is 
presented, followed by the save area 
in the next higher level. The lowest 
save area is assumed to be the 76 
bytes beginning with the byte 
addressed by register 13. These two 
save areas appear cnly if register 13 
points to a full word boundary and 
does not contain zeros. 

CCCCCCCC WAS ENTERED 

is the name of the module that stored 
register contents in the save area. 
This name is obtained from the RB. 

VIA LINK ddddd or VIA CALL ddddd 

indicates the macro instruction (LINK 
or CALL) used to give control to the 
next lower level module, and is the ID 
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operand, if it was specified, of the 
LINK or CALL macro instruction. 



AT EP ccccc ... 

is the entry point identifier, which 
appears only if it was specified in 
the SAVE macro instruction that filled 
the save area. 

SA hhhhhh 

is the starting address of the save 
area. 

WD1 hhhhhhhh 

is the first word of the save area 
(optional). 

HSA hhhhhhhh 

is the second word of the save area: 
starting address of the save area in 
the next higher level module. In the 
first save area in a job step, this 
word contains zeros. In all other 
save areas, this word must be filled. 

LSA hhhhhhhh 

is the third word of the save area 

(register 13) : starting address of 
the save area in the next lower level 

(called) module. If the module 
containing this save area did not fill 
the word, it contains zeros. 

RET hhhhhhhh 

is the fourth word of the save area 
(register 14) : return address 
(optional) ; if the called module did 
not fill the word, it contains zeros. 



EPA hhhhhhhh 

is the fifth word of the save area 



(register 15) : entry point to the 
called module. Use of this word is 
optional; if the called module did not 
fill the word, it contains zeros. 



RO hhhhhhhh Rl hhhhhhhh ... R12 hhhhhhhh 
are words 6 through 18 of the save 
area (registers through 12) : 
contents of registers through 12 for 
the module containing the save area 
immediately after the linkage. Use of 
these words is optional; if the called 
module did not fill these words, they 
contain zeros. 



INCORRECT BACK CHAIN 

indicates that the following lines may 
not be a save area because the second 
word in this area does not point back 
to the previous save area in the 
trace . 

INTERRUPT AT hhhhhh 

is the address of the next instruction 
to be executed in the problem program. 
It is obtained from the resume PSW 
word of the last PRB or LPRB in the 
active RB queue. 

PROCEEDING BACK VIA REG 13 

indicates that the next 2 save areas 
are (1) the save area in the lowest 
level module, followed by (2) the save 
area in the next higher level module. 
The lowest save area is the save area 
pointed to by register 13. These 2 
save areas appear only if register 13 
points to a f ullword boundary and does 
not contain zero. 
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CPUx PSA 




















hhhhhh 

hhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 

hhhhhhhh 


hhhhhhhh 

hhhhhhhh 


hhhhhhhh 

hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 

hhhhhhhh 


hhhhhhhh 

hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 
♦cccccccccccccccccccccccccccccccc* 


NUCLEUS 




















hhhhhh 
hhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh hhhhhhhh 
hhhhhhhhhhhhhhhhh 


hhhhhhhh 
hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 
*cccccccccccccccccccccccccccccccc* 


NUCLEUS 


DONT. 


















hhhhhh 
hhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
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♦cccccccccccccccccccccccccccccccc* 
♦cccccccccccccccccccccccccccccccc* 


REGS AT 


ENTRY TO ABEND (SNAP) 














FLTR 0-6 


hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh 


hhhhhhhhhhhhhhhh hhhhhhhhhhhhhhhh 


REGS 0-7 
REGS 8-15 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 


LOAD MODULE cccccccc 
















hhhhhh 
hhhhhh 

LINES 
hhhhhh 

hhhhhh 
LINE 


hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 

hhhhhh-hhhhhh SAME AS ABOVE 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhh SAME AS ABOVE 


hhhhhhhh 
hhhhhhhh 

hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 

hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 

hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 

hhhhhhhh 
hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 
* cccccccc cccccccccccccccccccccccc* 

♦ccccccccccccccccccecccccccccccec* 
♦cccccccccccccccccccccccccccccccc* 


CSECT dd 


OF cccccccc 
















hhhhhh 
hhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


hhhhhhhh 
hhhhhhhh 


♦cccccccccccccccccccccccccccccccc* 

♦cccccccccocccccccccccccccccccccc* 



The contents of main storage are given 
under 6 headings: CPUx PSA, NUCLEUS, 
NUCLEUS CONT. , LOAD MODULE cccccccc, CSECT 
dd OF cccccccc, and in the trace table, SP 
ddd BLK hh. Under these headings, the 
lines have the following format: 

• First entry: the address of the 
initial bytes of the main storage 
presented on the line. 

• Next 8 entries: 8 full words C32 
bytes) of main storage in hexadecimal. 

• Last entry (surrounded by asterisks): 
the same 8 full words of main storage 
in EBCDIC. Only A through Z, through 
9, and blanks are printed; a period is 
printed for anything else. 

The following lines may also appear: 

LINES hhhhhh-hhhhhh SAME AS ABOVE 

are the starting addresses of the 
first and last lines for a group of 
lines that are identical to the line 
immediately preceding. 

LINE hhhhhh SAME AS ABOVE 

is the starting address of a line that 
is identical to the line immediately 
preceding. 



CPUx PSA (Model 65 Multiprocessing dumps 

only) 

identifies the next lines as the 
contents of the prefixed storage area 
(PSA) -- through U095 (FFF). If the 
system is operating in partitioned 
mode (1 CPU) , x is the CPU 
identification. If the system is 
operating in a 2 CPU multisystem mode, 
both PSAs are printed, the first under 
the heading CPUA PSA and the second 
under CPUB PSA. 

NUCLEUS 

identifies the next lines as the 
contents of the nucleus of the control 
program. 

NUCLEUS CONT. 

identifies the next lines as the 
contents of the part of the nucleus 
that lies above the trace table. 

REGS AT ENTRY TO ABEND or REGS AT ENTRY TO 

SNAP 

identifies the next 3 lines as the 
contents of the floating point and 
general registers when the abnormal 
termination routine received control 
in response to an ABEND macro 
instruction or when the SNAP routine 
received control in response to a SNAP 
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macro instruction. These are not the 
registers for the problem program when 
the error occurred. 



FLTR 0-6 

indicates the contents of floating 
point registers f 2, 4, and 6. 

REGS 0-7 

indicates the contents of general 
registers through 7. 

REGS 8-15 

indicates the contents of general 
registers 8 through 15. 



LOAD MODULE cccccccc 

identifies the next lines as the 
contents of the main storage area 
occupied by the load module cccccccc 
addressed by an LLE or RB. All the 
modules for the job step are dumped 
under this type of heading. Partial 
dumps do not contain this information. 

CSECT hhhh OF cccccccc 

identifies the next lines as the 
contents of the main storage area 
occupied by the control section 
(CSECT) indicated by hhhh. This 
control section belongs to the 
scatter- loaded load module cccccccc. 



TRACE TABLE 




























DSP 


NEW PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


Rl 


hhhhhhhh 


SW 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 


I/O 


OLD PSW 


hhhhhhhh 
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R15/R0 


hhhhhhhh 


hhhhhhhh 


Rl 


hhhhhhhh 


RES 
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TCB 
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TME 


hhhhhhhh 


SIO 


CC/DEV/CAW 
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RES 
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TCB 
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TME 


hhhhhhhh 


SVC 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


Rl 
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RES 
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TCB 


hhhhhhhh 


TME 


hhhhhhhh 


PGM 


OLD PSW 


hhhhhhhh 


hhhhhhhh 
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Rl 
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RES 
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TCB 


hhhhhhhh 


TME 


hhhhhhhh 


EXT 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 
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Rl 


hhhhhhhh 


RES 


hhhhhhhh 


TCB 


hhhhhhhh 


TME 


hhhhhhhh 



TRACE TABLE (SNAP dumps only) 

identifies the next lines as the 
contents of the trace table. Each 
trace table entry is presented on one 
line; the name at the beginning of 
each line identifies the type of entry 
on the line: 



• DSP Dispatcher entry 

• I/O Input/output interruption entry 

• SIO Start input- output (SIO) entry 

• SVC Supervisor call (SVC) 

interruption entry 

• PGM Program interruption entry 

• EXT External interruption entry 

OLD PSW hhhhhhhh hhhhhhhh 

is the PSW stored when the 
interruption represented by the entry 
occurred. 

NEW PSW hhhhhhhh hhhhhhhh 

is the new PSW stored in the entry. 

CC/DEV/CAW hhhhhhhh hhhhhhhh 

contains, in the first 2 digits: 
completion code. 

contains, in the next 6 digits: 
device type. 



contains, in the last 8 digits: 
address of the channel address word 
(CAW) stored in the entry. 

R15/RO hhhhhhhh hhhhhhhh 

contains, in the first 8 digits: 
contents of register 15 stored in the 
entry. 

contains, in the last 8 digits: 
contents of register stored in the 
entry. 

CSW hhhhhhhh hhhhhhhh 

is the channel status word (CSW) 
stored in the entry. 

Rl hhhhhhhh 

is the contents of register 1 stored 
in the entry. 

RES hhhhhhhh 

is reserved for future use; all digits 
are zeros. 

SW hhhhhhhh 

is reserved for future use; all digits 
are zeros. 

TCB hhhhhhhh 

is the starting address of the TCB 
associated with the entry. 

TME hhhhhhhh 

is a representation of the timer 
element associated with the entry. 
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TRT 
X DSP 


NEW PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


NUA 


hhhhhhhh 


NUB 


hhhhhhhh 


TME 


hhhhhh 


X I/O 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


CSW 


hhhhhhhh 
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R1 


hhhhhhhh 


OLA 
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OLB 
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TME 


hhhhhh 


X SIO 
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OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


OLA 


hhhhhhhh 


OLB 


hhhhhhhh 


TME 


hhhhhh 


X PGM 


OLD PSW 


hhhhhhhh 


hhhhhhhh 


R15/R0 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


OLA 


hhhhhhhh 


OLB 


hhhhhhhh 


TME 


hhhhhh 


X EXT 


OLD PSW 


hhhhhhhh 
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MSK 


hhhhhhhh 
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hhhhhhhh 


TME 


hhhhhh 
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hhhhhhhh 
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R15/R0 


hhhhhhhh 


hhhhhhhh 


R1 


hhhhhhhh 


APF 


yyhhhhhh 


OLB 


hhhhhhhh 


TME 


hhhhhh 



TRT (MVT with Model 65 multiprocessing 

dumps only) 

identifies the next lines as the 
contents of the trace table. Each 
trace table entry is presented on one 
line; the letter and name at the 
beginning of each line identify the 
CPU and the type of entry, 
respectively: 



• DSP Dispatcher entry. 

• I/O Input/output interruption 

entry. 

• SIO Start input/output entry. 

• SVC Supervisor call interruption 

entry. 

• PGM Program interruption entry. 

• EXT External interruption entry. 

• SSM Set system mask entry. 

OLD PSW hhhhhhhh hhhhhhhh 

is the PSW stored when the 
interruption represented by the entry 
occurred. 

NEW PSW hhhhhhhh hhhhhhhh 

is the new PSW stored in the entry. 

CC/DEV/CAW hhhhhhhh hhhhhhhh 

contains, in the first 2 digits: 
completion code; in the next 6 digits: 
device type; in the last 8 digits: 
address of the channel address word 
stored in the entry. 

R15/R0 hhhhhhhh hhhhhhhh 

contains, in the first 8 digits: 
contents of register 15; in the last 8 
digits: contents of register 0, both 
as stored in the entry. 



CSW hhhhhhhh hhhhhhhh 

is the channel .status word stored in 
the entry. 

Rl hhhhhhhh 

is the contents of register 1 as 
stored in the entry. 

TCB hhhhhhhh 

is the starting address of the TCB 
associated with the entry. 

NUA hhhhhhhh 

is the starting address of the new TCB 
for CPU A, as stored in the entry. 

OLA hhhhhhhh 

is the starting address of the old TCB 
for CPU A, as stored in the entry. 

MSK hhhhhhhh 

is the STMASK of the other CPU as 
stored in the entry. 

NUB hhhhhhhh 

is the starting address of the new TCB 
for CPU B, as stored in the entry. 

OLB hhhhhhhh 

is the starting address of the old TCB 
for CPU B, as stored in the entry. 

TQE hhhhhhhh 

is the first word of the timer queue 
element stored in the entry, provided 
a timer interrupt occurred. 

TME hhhhhhhh 

is a representation of the timer 
element associated with the entry. 

AFF yyhhhhhh 

contains, in the first 2 digits: the 
ID of the locking CPU at the time of 
the interrupt; in the last 6 digits: 
starting address of the old TCB for 
CPU A, as stored in the entry. 
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SP ddd 



hhhhhh 
hhhhhh 



hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



•cecccceccccceccccccccccccecececc* 
♦cccccceccccccccccceccccccccccccc* 



END OF DUMP 



SP ddd 

identifies the next lines as the 
contents of a block of main storage 
obtained through a GETMAIN macro 
instruction, and indicates the subpool 
number (ddd) . The part of subpool 252 
that is the supervisor work area is 
presented first, followed by the 
entire contents of any problem program 
subpools (0 through 127) in existence 
during the dumping. 

END OF DUMP 

indicates that the dump or snapshot is 
completed. If this line does not 
appear, the ABDUMP routine was 
abnormally terminated before the dump 
was completed, possibly because enough 
space was not allocated for the dump 
data set. 



Guide to Using an ABEND/SNAP Dump (MVT) 

Cause of Abnormal Termination : Evaluate 
the user (USER=decimal code) or system 
(SYSTEM=hex code) completion code using 
Appendix B or the publication Messages and 
Codes . 

Dumped Task ; Check the ID field for an 
indication of which task is being dumped in 
relation to the task that was abnormally 
terminated: 

• 001 indicates a partial dump of a 
subtask 

• 002 indicates a partial dump of the 
invoking task 

If the ID field is absent, the dump 
contains a full dump of the task that was 
abnormally terminated. 

Active RB Queue : The first RB shown on the 
dump represents the oldest RB on the queue. 
The RB representing the load module that 
had control when the dump was taken is 
third from the bottom. The last RB 
represents the ABDUMP routine and the 
second from last, the ABEND routine. The 
load module name and entry point (for a 
PRB) are given in a contents directory 
entry, the address of which is shown in the 
last 3 bytes of the FL/CDE field. 



Program Check PSW : The program check old 
PSW is the fifth entry in the first line of 
each RB printout. It is identified by the 
subheading APSW. For debugging purposes, 
the APSW of the third RB from the bottom of 
the dump is most useful. It provides the 
length of the last instruction executed in 
the program (bits 32,33), and the address 
of the next instruction to be executed 
(bytes 5-8). 

Load List : Does the resume PSW indicate an 
instruction address outside the limits of 
the load module that had control at the 
time of abnormal termination? If so, look 
at the LLEs on the load list. Each LLE 
contains the CDE address in the dump field 
labeled RSP-CDE. 

CDEs : The entries in the contents 
directory for the region are listed under 
the dump heading CDE. The printouts for 
each CDE include the load module and its 
entry point. If you have a complete dump, 
each load module represented in a CDE is 
printed in its entirety following the 
NUCLEUS section of the dump. 

Trace Table (SNAP dumps only) : Entries on 
an MVT SNAP dump, if valid, represent 
occurrences of SIO, external, SVC, program, 
I/O, and dispatcher interruptions. SIO 
entries can be used to locate the CCW 
(through the CAW) , which reflects the 
operation initiated by an SIO instruction. 
If the SIO operation was not successful, 
the CSW STATUS portion of the entry will 
show you why it failed. EXT and PGM 
entries are useful for locating the 
instruction where the interruption occurred 
(bytes 5-8 of the PSW). 

SVC trace table entries provide the SVC old 
PSW and the contents of registers 0, 1, and 
15. The PSW offers you the hexadecimal SVC 
number (bits 20-31), the CPU mode (bit 15), 
and the address of the SVC instruction 
(bytes 5-8). The contents of registers 
and 1 are especially useful in that many 
system macro instructions pass key 
information in these registers. (See 
Appendix A.) 

I/O entries reflect the I/O old PSW and the 
CSW that was stored when the interruption 
occurred. From the PSW, you can learn the 
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address of the device that caused the 
interruption (bytes 2 and 3) , the CPU state 
at the time of interruption (bit 15) , and 
the instruction address where the 
interruption occurred (bytes 5-8). The CSW 
provides you with the unit status (byte 4), 
the channel status (byte 5), and the 
address of the previous CCW plus 8 (bytes 
0-3). 

You can use the DSP entry to delimit the 
entries in the trace table. To find all 
entries for the terminated task, scan word 
7 of each trace table entry for the TCB 
address in a DSP entry. The lines between 
this and the next DSP entry represent 
interruptions that occurred in the task. 

Region Contents : Free areas for the region 
occupied by the dumped task are identified 
under headings PQE and FBQE. The field 



labeled SZ gives the number of bytes in the 
free area represented by the FBQE. 

Subpool Contents ; Free and requested areas 
of the subpools used by the dumped task are 
described under the dump heading MSS. 
Subpool numbers are given under the SPID 
column in the list of SPQEs. If a GETMAIN 
macro instruction was issued without a 
subpool specification, space is assigned 
from subpool 0. Thus, two SPQEs may exist 
for subpool 0. The sizes of the requested 
areas and free areas are given under the LN 
column in the lists of DQEs and FQEs, 
respectively. 

Load Module Contents : The contents of each 
load module used by the job step are given 
under the heading XL. Each entry includes 
the sizes (LN) and starting addresses (ADR) 
of the control sections in the load module. 
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Indicative Dump 



First digit: 



An indicative dump is issued when a task is 
abnormally terminated by an ABEND macro 
instruction, and a dump is requested, but a 
dump data set is not available, due either 
to omission or incorrect specification of a 
SYSABEND or SYSUDUMP DD statement. An 
indicative dump is issued automatically on 
the system output (SYSOUT) device. 

Systems with MVT do not issue indicative 
dumps. 



Contents of an Indicative Dump 

This explanation of indicative dumps 
utilizes capital letters for the headings 
found in all dumps, and lowercase letters 
for information that varies with each dump. 
The lowercase letter used indicates the 
mode of the information, and the number of 
letters indicates its length: 

• h represents 1/2 byte of hexadecimal 
information 

• d represents 1 byte of decimal 
information 

• c represents a 1-byte character 



Figure 19 shows the contents of an 
indicative dump. You may prefer to follow 
the explanation on your own indicative 
dump. 

CONTROL BYTE=hh 

describes the contents of the 
indicative dump. 



Bit Setting Meaning 
Instruction image not 

present 
Instruction image present 



Floating-point registers 
not present 

Floating-point registers 
present 

One general register set 

present 

Two general register sets 

present 

All active RBs present 
All active RBs not present 



Last digit: 

Digit in 
Hexadecimal Meaning 

All loaded RBs present 



8 



All loaded RBs not present 



TCB FLAGS=hh 

is the first byte of TCBFLGS field 
(byte 29 in the TCB for the program 
being dumped) : task end flag byte: 

Bit Setting Meaning 

1 Abnormal termination in 

process 

1 1 Normal termination in 

process 

2 1 Abnormal termination was 

initiated by the resident 
ABTERM routine 




Figure 19. Contents of an Indicative Dump 
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Page of GC28-6670-5,6, Revised April 16, 1973, By TNL: GN2 8-2545 



3 1 ABTERM routine entered 

because of program 
interruption 

4 1 Reserved for future use 

5 1 Data set closing initiated 

by the ABTERM routine 

6 1 The ABTERM routine 

overlaid some or all of 
the problem program 

7 1 The system prohibited 

queuing of asynchronous 
exit routines for this 
task 

NO. ACTIVE RB=dd 

is the number of active RBs presented 
in the dump. 

NO. LOAD RB=dd 

is the number of RBs in the load list 
presented in the dump. 



COMPLETION CODE SYSTEM=hhh USER=dddd 

is the completion code supplied by the 
control program (SYSTEM=hhh) or the 
problem program (USER=dddd). Both 
SYSTEM=hhh and USER=dddd are printed; 
however, one of them is always zero. 



• Lost control to the input/output 
interruption handler, which 
subsequently terminated abnormally. 

• Was abnormally terminated by the 
control program because of a program 
i nterruption. 

• Issued an ABEND macro instruction to 
request an abnormal termination. 

If REGISTER SET 2 also appears in the 
dump, the lines under REGISTER SET 1 
give the general register contents for 
a type II, III, or IV SVC routine 
operating under an SVRB. 

REGISTER SET 2 

indicates that the next 2 lines give 
the contents of general registers 
through 7 and 8 through 15 for a 
program being executed under control 
of an RB other than an SVRB when the 
program last passed control to a type 
II, III, or IV SVC routine. 

IN STRUCTION IMAGE=hhhhhhhhhhhhhhhhhhhhhhhh 
is 12 bytes of main storage, with the 
instruction that caused a program 
interruption in the right part of the 
printout. This field appears only if 
a program interruption occurred and is 
also valid when the instruction length 
in the resume PSW is 0. 



vCvrvCC m • • 

explains the completion code or, 
program interruption occurred: 



if a 



PROGRAM INTERRUPTION CCCCC... AT 

LOCATION hhhhhh 

where ccccc is the program 
interruption cause: OPERATION, 
PRIVILEGED OPERATION, EXECUTE, 
PROTECTION, ADDRESSING, 
SPECIFICATION, DATA, FIXED-POINT 
OVERFLOW, FIXED-POINT DIVIDE, 
DECIMAL OVERFLOW, DECIMAL DIVIDE, 
EXPONENT OVERFLOW, DECIMAL 
DIVIDE, EXPONENT OVERFLOW, 
EXPONENT UNDERFLOW, SIGNIFICANCE, 
or FLOATING-POINT DIVIDE; and 
hhhhhh is the address of the 
instruction being executed when 
the interruption occurred. 



REGISTER SET 1 

indicates that the next 2 lines give 
the contents of general registers 
through 7 and 8 through 15 for a 
program being executed under control 
of an RB when it: 

• Passed control to a type I SVC 
routine through an SVC instruction 
and the routine terminated 
abnormally. 



hhhhhhhhhhhhhhhh hhhhhhhhhhhhhhhh 
hhhhhhhhhhhhhhhh hhhhhhhhhhhhhhhh 

are the contents of floating-point 
registers 0, 2, 4, and 6 when the 
abnormal termination occurred. This 
field appears only if the floating 
point option is present. The first 2 
digits of each register are the 
characteristic of the floating point 
number. The last 14 digits are the 
mantissa. 



PROGRAM ID=cccccccc 

is the XRBNM field (bytes through 
7) : in PRB, LRBs, and LPRBs, the 
program name; in IRBs, the first 
character contains flags for the timer 
or, if the timer is not being used, 
contains no meaningful information; in 
SVRBs for a type II SVC routine, 
contains no meaningful information; in 
SVRBs for a type III or IV SVC 
routine, the first 4 bytes contain the 
relative track address (TTR) of the 
load module in the SVC library and the 
last U bytes contain the SVC number in 
signed, unpacked decimal; in SIRBs, 
the name of the error routine 
currently occupying the 4 00-byte 
input/output supervisor transient 
area. 
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RB TYPE=hh 

indicates the type of active RB 

hh Type of RB 

00 PRB that does not contain entry 

points identified by IDENTIFY 

macro instructions 



PM=h 



is bits 36 through 39 of PSW: 
mask. 



program 



IA=hhhhhh 

is bits 40 through 63 of PSW: 
instruction address. 



10 PRB that contains one or more 
entry points identified by 
IDENTIFY macro instructions 

20 LPRB that does not contain entry 
points identified by IDENTIFY 
macro instructions 

30 LPRB that contains one or more 
entry points identified by 
IDENTIFY macro instructions 

40 IRB 

80 SIRB 

CO SVRB for a type II SVC routine 

DO SVRB for a type III or IV SVC 
routine 

E0 LPRB for an entry point identified 
by an IDENTIFY macro instruction 

F0 LRB 

ENTRY POINT=hhhhhh 

is the XRBEP field (bytes 13 through 
15) : address of entry point in the 
program. 

RESUME PSW 

XRBPSW field (bytes 16 through 23): 
is the contents of the resume PSW. 



SM=hh 



K=h 



is bits through 7 of PSW: system 
mask. 

is bits 8 through 11 of PSW: 
protection key. 



AMWP=h 

is bits 12 through 15 of PSW: 
indicators. 

IC=hhhh 

is bits 16 through 31 of PSW: 
interruption code. 

IL.CC=h 

is bits 32 through 35 of PSW: 
instruction length code (bits 32 and 
33) and condition code (bits 34 and 
35). 



PROGRAM ID=cccccccc 

is the XRBNM field (bytes through 
7): program name. 

RB TYPE=hh 

indicates the type of RB: 



hh 
20 



30 



E0 



F0 



Type of RB 

LPRB that does not contain entry 

points identified by IDENTIFY 

macro instructions. 

LPRB that contains one or more 

entry points identified by 

IDENTIFY macro instructions. 

LPRB for an entry point identified 

by an IDENTIFY macro instruction. 

LRB. 



ENTRY POINT=hhhhhh 

is the XRBEP field (bytes 13 through 
15): address of entry point in the 
program. 

Guide to Using an Indicative Dump 

Completion Code : Evaluate the user 
(USER=decimal code) or system (SYSTEM=hex 
code) completion code using either Appendix 
C of this publication or the publication 
Messages and Codes . The line under the 
completion code gives a capsule explanation 
of the code or the type of program 
interruption that occurred. 

Instruction Address : If a program 
interruption occurred, get the address of 
the erroneous instruction in the last 3 
bytes of the field labeled INSTRUCTION 
IMAGE. 

Active RB Queue : RBs are shown in the 
first group of two- line printouts labeled 
PROGRAM ID and RESUME PSW, with the most 
recent RB shown first. There are two lines 
for as many RBs indicated by NO. ACTIVE 
RB=dd. 

Register Contents : General register 
contents at the time a program last had 
control are given under the heading 
REGISTER SET 2 or, if this heading is not 
present, under REGISTER SET 1. Register 
contents, particularly those of register 
14, may aid you in locating the last 
instruction executed in your program. 
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Storage Dumps 



IMDSADMP SERVICE AID 



Storage dumps record the contents of main 
storage from location 00 to the end of 
printable storage - 

Storage dumps are produced by the damage 
assessment routine (DAR) or other system 
recovery routines, the Console Dump 
facility, or the stand-alone service aid 
program IMDSADMP. 



DAMAGE ASSESSMENT ROUTINE (DAR) 

The damage assessement routine produces a 
storage dump when a system task fails and 
is designed to provide increased system 
availability in the event of system 
failure. The storage dump is written to 
the SYS1.DUMP data set. 

If a system routine fails, DAR attempts 
to reinitialize the failing task, thereby 
permitting the system to continue operation 
without interruption. DAR permits the 
system to continue processing in a degraded 
condition if it encounters a system failure 
that does not permit total reinstatement of 
the affected task or region. The operator 
will be informed, via a WTO, that the 
system is in an unpredictable state; he 
then must decide whether or not 
already-scheduled jobs should be allowed to 
attempt completion. 

Note : If TSO is installed in the system 
and a failure occurs in the TSO subsystem 
or in the operating system the TSO SWAP 
data set must be recorded for use in 
diagnosis if needed. The system recovery 
routines do not do this. The IMDPRDMP 
service aid can be used as a 
high-performance dumping program for this 
purpose by directing its output to tape. 
Refer to the service Aids publication for 
details of this usage of the IMDPRDMP 
program. 



CONSOLE DUMP 



In situations where the system is not 
operative, an IMDSADMP program is loaded 
into storage through use of the IPL 
facilities. The storage dump taken may be 
written in a high-speed version to tape or 
disk, and in a low speed version to tape or 
printer. The high-speed IMDSADMP dump must 
be processed by the IMDPRDMP program. The 
low-speed tape output may be processed by a 
program such as the IEBGENER utility 
program. The format of the low- speed 
IMDSADMP output is similar to the general 
format listing produced by the IMDPRDMP 
program and therefore is not illustrated in 
this publication- A sample IMDSADMP 
listing and a discussion of the program are 
contained in the Service Aids publication. 



SYSTEM FAILURE 

If a system failure occurs, the damage 
assessment routine immediately attempts to 
write a storage dump to the SYS1.DUMP data 
set. A system failure may be caused by a 
failure in any of the following system 
tasks: 

MFT: 



Communications Task 
Master Scheduler Task 
Log Task 

MVTs 

System Error Task 
Rollout/Rollin Task 
Communications Task 
Master Scheduler Task 
Transient Area Fetch Task 

A system failure is also caused by an 
ABEND recursion in other than OPEN, CLOSE, 
ABDUMP, or STAE; by a failure of a task in 
•must complete' status; or, in MFT only, by 
a failure in the scheduler if no SYSABEND 
or SYSUDUMP DD card is provided. 



The Console Dump function is designed to 
meet the requirements for a dynamic main 
storage dumping tool in the operating 
system- The operator initiates the Console 
Dump from the primary console via a DUMP 
command. Execution of the function allows 
a dump to be taken to the SYS1.DUMP data 
set of all or selective portions of main 
storage. The dump operation is performed 
during system operation and requires no 
IPL. The storage dump may then be 
formatted and printed by the IMDPRDMP 
Service Aid program. Refer to the 
Operator's Guide publication for details of 
the DUMP command. 



THE SYS1.DUMP DATA SET 

The SYS1.DUMP data set may reside on tape 
or on a direct access device. 

Tape 

If you wish to have the SYS1. DUMP data set 
reside on tape, you may specify the tape 
drive during IPL. If the drive has not 
been made ready prior to IPL, a MOUNT 
message is issued to the console, 
specifying the selected device. The device 
should be mounted with an unlabeled tape. 



68 Programmer's Guide to Debugging (Release 21) 



After writing a storage image dump, the 
damage assessment routine writes a tape 
mark and will position the tape to the next 
file. The tape drive will remain in a 
ready state to receive another storage 
image dump. 



Direct Access 

If you wish to have the SYS1.DUMP data set 
placed on a direct access device, you may 
preallocate the data set at system 
generation or prior to any IPL of the 
system. The following restrictions applys 

• The data set name must be SYS1.DUMP. 

• The data set must be cataloged on the 
IPL volume. 



• The data set may be preal located on any 
volume that will be online during 
system operation. 



• The data set must be sequential. 

• Sufficient space must be allocated to 
receive a storage image dump for all of 
main storage. 

When a direct access device is used for 
the SYS1.DUMP data set, the data set can 
hold only one storage dump. If additional 
failures occur, and if the SYS1.DUMP data 
set is occupied, DAR does not attempt to 
write another storage image dump. 

Use the IMDPRDMP service aid to format 
and list the SYS1.DUMP data set. 



Storage Dumps 69 



IMDPRDMP Output 

Main storage information processed by the 
IMDPRDMP program is presented in six 
different output formats. The output 
format used is determined by the function 
of the particular area of the dumped 
system's main storage that is being 
printed. Two of these formats, the queue 
control block trace and the link pack area 
map, are invoked by specific format 
statements. A third format is used to 
print the major system control blocks. Two 
formats are used for TSO; one for system 
control blocks and the other for user 
control blocks. Any areas of the dumped 
system's main storage that do not fall into 
any of the aforementioned functional 
categories are processed in the general 
format . 



• The number of permanent I/O errors 
encountered during the execution? 

• The average number of buffers used for 
each operation performed during this 
execution; 

• The number of blocks read from the TSO 
swap data sets; 

• The ratio of the number of times the 
read routine was called to the number 
of times the requested address was not 
in a buffer. 

• When processing Generalized Trace 
Facility output', the number of trace 
records processed. 



Dump List Headings : Each page of output 
listing contains a heading. This heading 
has the optional user specified title, the 
name of the module that invoked the dump, 
the date and the time the dump was taken 
except when processing Generalized Trace 
Facility output when the heading will be 
"EXTERNAL TRACE - DD ddname. " Note : If 
the dump was produced by IMDSADMP on a 
system with the time-of-day (TOD) clock, 
IMDPRDMP can not determine the time at 
which the dump was taken; the time is 
replaced by "TOD CLK." 

Dump Header : If the dump was produced by 
SVC DUMP, IMDPRDMP will print the title 
taken from the dump header record. A 
maximum of 100 characters are printed on 
the second line of the first page of the 
output listing. 

Output Comments : While formatting the 
dump, the IMDPRDMP program occasionally is 
unable to locate, format and print a 
control block. On those occasions IMDPRDMP 
prints a comment explaining why the control 
block could not be formatted and printed. 
These comments are printed within the body 
of the formatted dump and are part of the 
IMDPRDMP output. A complete list of these 
output comments along with further 
explanations is contained at the end of 
this chapter. 

Summary Information : In addition to 
formats, the following summary information 
is printed at the end of each execution of 
IMDPRDMP : 

• The number of entries to the read 
routine; 

• The number of times that the required 
address was not found in a buffer; 

• The number of blocks read from the dump 
data set; 



QUEUE CONTROL BLOCK TRACES 

In a multiprogramming environment, requests 
for system resources are enqueued. This 
process is accomplished through the use of 
queue control blocks (QCBs). 

Certain system failures, such as task 
contention deadlocks, become evident to the 
user upon examination of a queue control 
block trace. When requested through the 
use of the QCBTRACE statement, the QCB 
trace appears on a separate page of the 
IMDPRDMP program dump listing. The trace, 
a sample of which appears in Figure 20, 
contains a listing of all queue control 
blocks that were present in the dumped 
system, and is available to users who are 
processing main storage information 
gathered from an MVT or MFT system. 

(For more information on system resource 
queuing, see IBM System/360 Operating 
System: MVT Supervisor . GY28-6659.) 

The page of the IMDPRDMP listing 
containing the Queue Control Block trace is 
identified by two heading lines. The first 
line contains an optional title, the name 
of the module that invoked the dump, and 
the date and time that the information was 
gathered from the dumped system. The 
second line of the heading identifies the 
page as containing a Queue Control Block 
trace. The individual QCBs are then listed 
for each Task Control Block. Each Queue 
Control Block is formatted as follows: 

MAJOR hhhhhh 

The starting address of a major queue 
control block, the contents of which 
are given, indented, on the line or 
lines below. 

NAME cccccccc 

The name of the system resource 
represented by the major QCB. 
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SAMPLE QCB TRACE MODULE IMDSADMP DATE 7/04/70 TIME 0.10 PAGE 2 

**** QUEUE CONTROL BLOCK TRACE ***♦ 



MAJOR 024100 NAME SYSDN 

MINOR 0239AO 

QEL 024068 

MINOR 023838 

QEL 023ED8 



NAME FF SYS1.LINKLIB 
TCB 023488 SHARED 

NAME FF SYSl.MACLIB 
TCB 023448 SHARED 



MAJOR 0235E8 NAME SYSIEFSD 

MINOR 0235C8 NAME FF Q5 

QEL 023208 TCB 023480 EXCLUSIVE 
QEL 023C10 TCB 023 8E0 EXCLUSIVE 



Figure 20. Queue Control Block Trace Sample 



MINOR hhhhhh 

The starting address of the minor 
queue control block. Contents are 
given on this line or the lines below. 

NAME hh cccccccc 

The first two characters appearing 
after the NAME field identifier 
indicate the scope of the minor QCB 
being dumped. If the scope is given 
as hexadecimal FF, the name of the QCB 
is known to the entire operating 
system. If the scope indicator is 
hexadecimal 00 or 10 through F0, the 
name of the QCB is known only to the 
job step. The scope indicator shows 
the storage protection key of the TCB 
that enqueued this minor QCB. The 
NAME field also contains the name of 
the specific system resource 
represented by the minor QCB. 

QEL hhhhhh 

The address of a queue element (QEL) 
associated with the minor QCB 
described on the line above. A QEL 
line appears for each resource 
requested by the task associated with 
the minor QCB. 

TCB hhhhhh 

The starting address of the task 
control block of the requesting task. 
This task requests a specific system 
resource through the use of the QEL 
indicated on this line. 

SHARED or EXCLUSIVE 

This indicator tells whether the 
system resource is available to one 
task (EXCLUSIVE) or several tasks 
(SHARED) . 



LINK PACK AREA MAPS 

Information on routines residing in either 
the MVT link pack area or the MFT resident 
reenterable load module area of the dump 
system is available to the user through use 
of the LPAMAP (link pack area map) format 
statement. 



For users who are processing an MVT 
dump, the IMDPRDMP program produces a 
listing of all routines loaded into the 
link pack area by the nucleus 
initialization program (NIP) . For MFT 
dumps, this list contains information 
pertaining to all resident reentrant 
routines loaded into the reenterable load 
module area by NIP. 

The IMDPRDMP user will find the link 
pack area map, for MVT, or the reenterable 
load module area map, for MFT, to be a 
useful tool in isolating system failures 
that occurred in program modules that 
reside outside the user's partition or 
region. If requested, the applicable map 
appears on a separate page of the IMDPRDMP 
program dump listing. A sample Link Pack 
Area map is shown in Figure 21 . 



The dump listing page containing the 
link pack area map is identified by two 
heading lines. The first line contains the 
optional title supplied by the user, the 
name of the module that invoked the dump, 
and the date and time that the information 
was gathered from the dumped system. The 
second line of the heading identifies the 
page as containing a link pack area map. 
Information on each module contained in the 
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link pack area or reenterable load module 
area,, is given in the following format: 



NAME cccccccc 

The name of the load module 
represented by this entry. 

EPA hhhhhh 

The entry point address of the module 
identified on the corresponding line 
in the NAME column. 

STA hhhhhh 

The starting address of the named 
module's control section. 



LNGH hhhhhh 

The length, in bytes, of the control 
sections in the load module described 
on this line. 

TYPE ccccc 

The attributes of the control block 
associated with the module being 
described on this line. Under MVT, 
the type of the contents directory 
entry (CDE) associated with the module 
is given. The type may be either 
MAJOR or MINOR. Under MFT, the type 
is shown as either a loaded request 
block (LRB) or a loaded program 
request block (LPRB) . 
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MODULE IMDSA9MP DATE 


11/12/70 TIME 00.15 PAP C 0001 




* * 


* * 


LINK 


PACK AREA MAP *** 


* 


NAME 


EPA 


STA 


LNGH 


TYPE 




IEELWAIT 


072418 


072418 


0C03F8 


MAJOR 




IGG0209Z 


C748C0 


C74800 


C00400 


MAJOR 




IGG0 201Z 


C74CO0 


C74C00 


000400 


MAJOR 




IGG0201Y 


C75000 


C75000 


000400 


MAJOR 




IGGG200Z 


C75400 


C75400 


000400 


MAJOR 




IGG0200Y 


C75800 


C75800 


000400 


MAJOR 




IG60200H 


C75COO 


C75CC0 


000400 


MAJOR 




IGG0200G 


076000 


C760C0 


000400 


MAJOR 




IGG0200F 


076400 


0764C0 


000400 


MAJOR 




IGG0200A 


C76800 


076800 


000400 


MAJOR 




IGG0199M 


076C00 


O76C00 


000400 


MAJOR 




IGG0196B 


C77000 


077000 


000400 


MAJOR 




IGG0iy6A 


C77400 


C77400 


C00400 


MAJOR 




IGG01917 


C77800 


C778C0 


000400 


MAJOR 




IGG01911 


C77C00 


077C00 


C00400 


MAJOR 




IGG01910 


C78000 


078000 


C00400 


MAJOR 




IGG01910 


C784C0 


C78400 


000400 


MAJOR 




IGGQ191G 


C78800 


C78800 


000400 


MAJOR 




IGG01910 


C78C0C 


C78CC0 


000400 


MAJOR 




IGGC191B 


C79000 


C790C0 


000400 


MAJOR 




IGG0191A 


C79400 


C79400 


000400 


MAJOR 




IGG0190S 


C79800 


C79800 


000400 


MAJOR 




IGG0190N 


079CO0 


C79C00 


000400 


MAJOR 




IGG0190M 


C7A000 


C7A000 


000400 


MAJOR 




IGG0190L 


C7A40Q 


C7A400 


000400 


MAJOR 




IGC0005E 


C7A800 


C7A800 


000400 


MAJOR 




I3CC002 


C7AC00 


C7AC00 


000400 


MAJOR 




IGCC001I 


C7B360 


C7B360 


C00400 


MAJOR 




IGG019CK 


C7CA00 


C7CA00 


000060 


MAJOR 




IGG019BC 


C7CA6C 


C7CA6C 


0000E8 


MAJOR 




I3G019BD 


C7CB48 


C7CB48 


000128 


MAJOR 




IGG019A0 


C7CC70 


C7CC70 


OOOOCO 


MAJOR 




IGG019AL 


C7CD30 


C7C030 


00C158 


MAJOR 




IGP019AC 


C70848 


07D848 


0000E8 


MAJOR 




IGG019CA 


C70930 


C7D93 


000088 


MAJOR 




I6GC19CB 


C7D9B8 


C7D9B8 


000098 


MAJOR 




IGG019AG 


C7DA50 


C7DA50 


000090 


MAJOR 




IGG019BE 


C7CAE0 


C7DAE0 


000188 


MAJOR 




IG6019AM 


C7DC68 


07DC68 


000078 


MAJOR 




IGGG19AN 


C7DCE0 


C70CE0 


000008 


MAJOR 




IGG019AV 


C7DDB8 


C7D0B8 


000058 


MAJOR 




IGG019K0 


070E10 


C7OE10 


OOOOFO 


MAJOR 




IGGC19MB 


07B760 


07B760 


0010A0 


MAJOR 




IGGC19MA 


C7CE88 


07CE88 


000978 


MAJOR 




IGG019CL 


C7E820 


07E820 


000040 


MAJOR 




IGG019CF 


C7DF00 


C7DFC0 


000100 


MAJOR 




IGG019CE 


07E038 


O7E038 


000088 


MAJOR 




IGGC19AJ 


C7E0C0 


07E0C0 


000120 


MAJOR 




IGG019AI 


C7E1E0 


C7E1E0 


000080 


MAJOR 




IGG019BB 


C7E86C 


C7E860 


00CC58 


MAJOR 




IGG019BA 


C7E260 


C7E260 


000180 


fAJOP 





-4 



Figure 21. Link Pack Area Map Sample 
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MODUIF IMDSADMP DATE 11/12/70 TIME 00.15 °AG£ 002° 


JOS 


J0B4 


STEP GO 


PROCSTEP STEP1 










***** CURRENT TASK ***** 


TC8 


020400 


RBP 0002E410 


PIE OOCOOOOO DEB 0002DABC TIO 0002EIFO 


CMP OOOOOOOO TRN 00000000 






MSS 0002E770 


PK-FLG FCOOOOOO FLG 00001B1B LLS OC02E3EO 


JLB OOOOOOOO JPQ 0002E3E8 






RG 0-7 0COC0CC0 C000C066 0002DFBC 00000000 00020660 0002D1E8 0002E234 0002DBA8 






RG 8-15 0C02CFA0 OOOCOOOO 0002DFC8 0OO5DF08 40050E56 00050F08 6007F060 60308342 






FSA 0006BF68 


TCB OOCOOOOO TME 00000000 JST 0002D400 


NTC OOOOOOOO OTC 0002D1E8 






LTC OCOOOOOO 


IQE OOOOCOOO EC8 0002DFC4 TSPR OCOOOOOO 


D-POE D002E770 SQS 0002DA90 






STA CCCCCOOO 


TCT OO02CF28 USR 00000000 OAR 00000000 


RES OOOOOOOO JSCB 0002E33C 


ACTIVE RBS 








PRB 


02E410 


RESV OCOOOCOO APSW OOOOOOCO WC-SZ-STAB 00040082 C L- 


-COE 0002E5E8 PSW FFF50009 A005DEF9 






Q/TTR OOOCOOOO KT-LNK 0002D400 NM GO EPA 05DE50 


STA 05DE50 LN 0001B0 ATR1 OB 


MAIN 


STORAGE 








O-PQ 


E 0002E770 FIRST 00025688 LAST 0002E688 




PQE 


02E688 


FFB 00C5ECC0 
TC8 0002D1E8 


LFB CCC5E0OO NPQ 00000000 PPQ 00000000 
RSI COOOFOOO RAD 0005D800 FLG 0000 




LOAD 


LIST 








COE 


02E3E8 


NM RETURNS 


LSE 01 RESP 01 ATR1 08 EPA 05DDC8 STA 


050OC8 LN 000088 


COE 


02BB50 


NM IGGC19CC 


USE 03 PESP 01 ATR1 BO EPA 07E928 STA 


07E928 LN C000D8 


CDE 


02BB20 


NM IGG019CH 


LSE 03 RESP 01 ATR1 BO EPA 07E8B8 STA 


07E8B8 LN 000070 


CDE 


02B730 


NM IGG019AC 


LSE 02 PESP 01 ATR1 BO EPA 070848 STA 


07D848 LN 0000E8 


COE 


02BBF0 


NM IGG019AQ 


USE 03 RESP 01 ATR1 BO EPA 07F020 STA 


07F020 LN 000078 


JOB 


PACK QUEUE 






CDE 


02E3E8 


NM RETURNS 


USE 01 RESP NA ATR1 OB EPA 05DOC8 STA 


0500C8 LN 000088 


CDE 


02E5E8 


NM GO 


USE 01 RESP NA ATR1 OB EPA 05DE50 STA 


05DE50 LN 0001BC 


DEB 


020ABC 


APPENDAGES 
PFX OOCOOOOO 


END OF EXT 07E8B8 S 10 000072 PCI 000D72 
C5C00006 00010BEO 1100C000 


CH END 000072 AB END 000072 






TC6 0402D400 


NDEB 1CC00O0O ASYN F800000C SPRG 00000000 


UPRG 0106BE18 PLST 1B000000 OCB FF05DFAC 






AVT 0402CA98 










FM-UCB START END TRKS 








580026AC 00020003 COC20003 0001 




TtOT 


02EIF0 


JOB J084 


STEP GO PROC STEP1 








OFFSET LN-STA CCNAHE TTR-STC STB-UCB 








0018 140401CI PGM=*.D0 00271500 800026AC 








002C 140O1C1 OUMMY C0271900 8C002AAC 





Figure 22. Sample of MVT Major Control Block Format 
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MAJOR SYSTEM CONTROL BLOCK FORMATS 



Formatting of the major system control 
blocks associated with a task is a function 
of either a FORMAT control statement, or 
one of the several noted parameters 
associated with the PRINT control 
statement. The control blocks of several 
tasks may be printed during one execution 
of IMDPRDMP. When more than one task is 
printed, the associated task control blocks 
(TCBs) are grouped into a TCB summary, 
listed following the printing of all 
requested tasks. This summary provides an 
index to the formatted TCBs by jobname. 
See the discussion "Task Control Block 
Summaries." 

For ease of identifying various dump 
printouts, specific headings are printed on 
each dump; such as FORMAT, DAR AND F0 3 
TASKS, PRINT CURRENT, and PRINT JOBNAME. 

Each task being printed begins on a new 
page, identified by two heading lines. The 
first heading line contains the optional 
title supplied by the user, the name of the 
module that invoked the dump, and the date 
and time that the information was gathered 
from the dumped system, and a page number. 
The second line of the heading identifies 
the particular task being printed. This 
task information is broken down into the 
following named fields: 

UNKNOWN 
JOB cccccccc 

The JOB field displays the 
eight- character name that was 
specified in the label field of the 
JOB statement. 

UNKNOWN indicates that the job name is 
unavailable. 

STEP cccccccc 

The STEP field shows the eight - 
character step name of the problem 
program associated with the task being 
dumped. This name was supplied in the 
label field of the EXEC statement. 

PROCSTEP cccccccc 

If the job step being displayed was 
invoked from a cataloged procedure, 
the step name of the cataloged 
procedure, as contained in the 
cataloged procedure's EXEC statement, 
is displayed in this field. 

If the task being printed was in control 
at the time the dump was taken, a third 



heading line follows the two previously 
described. The line "**** CURRENT TASK 
****" identifies the TCB associated with 
the task in control when the dump was 
taken. 

While formatting the dumped control 
blocks, IMDPRDMP may issue various output 
comments to assist the person who analyzes 
the printout. The output comments are 
discussed following the control block 
discussion. 

Specific formatting of the major system 
control blocks is dependent upon the 
operating system option under which the 
dumped system was operating. To allow the 
reader to concentrate on the particular 
operating system with which he is 
concerned, the discussion of control block 
formatting is divided into three parts: 
MVT, MFT, and the TSO option of MVT. 



MVT Control Block Formatting 



The formats described below are repeated 
for each requested task that is printed. A 
sample of the major system control blocks, 
as formatted from an MVT dump, is shown in 
Figure 22. 

MVT TASK CONTROL BLOCK (TCB) FORMATTING : 
The task control block (TCB) contains 
information that pertains to the specific 
task named in the heading lines that appear 
at the top of the page. Each TCB is 
formatted as follows: 

TCB hhhhhh 

The address of the task control block 
being displayed is given in this first 
field. 

RBP hhhhhhhh 

The address of the request block (RB) 
that was currently associated with the 
task represented by this TCB. 

PIE hhhhhhhh 

The address of the first program 
interrupt element (PIE) enqueued by 
this TCB. 

DEB hhhhhhhh 

The address of the beginning of the 
data extent block (DEB) queue that was 
associated with this task. 
Information on the contents of each 
DEB in the queue is given in a 
separate portion of this MVT dump 
1 ist ing . 
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TIO hhhhhhhh 

The address of the task input output 
table (TIOT) that was constructed 
during device allocation for the task 
represented by this TCB. The contents 
of this table are displayed in a later 
portion of this task's display. 

CMP hhhhhhh 

This word contains ABEND indicators 
and user and system completion codes. 
The usage of this field is as follows: 



byte 
1., 



.1.. 



. . XX xxxx 



Bit indicates that a 

dump had been requested. 

Bit 1 set indicates that 

a step ABEND had been 

requested. 

Bits 2 through 7 are 

reserved for future use. 



bytes 1-3 

The first 12 bits contain a system 
completion code. These codes and 
their meanings are explained in the 
publication IBM System/360 Operating 
System: Messages and Codes , GC28-6631 
under the heading "System Completion 
Codes." A user completion code is 
contained in the last 12 bits. 

For a system completion code of 0C0, 
denoting an imprecise interruption on 
a Model 91 or Model 195, digits six 
through eight contain the imprecise 
interruption configuration. These bit 
settings represent bits 16 through 27 
of the program old PSW (location 
X^S 1 ) at the time of the program 
exception. Therefore, in the TCB CMP 
field, bits 20 through 29 are 
significant for a Model 91, while a 
Model 195 makes use of all the bits 
(20 through 31). For further 
discussion on interpreting the 
imprecise interruption configuration 
refer to the publication IBM 
System/360 Operating System : 
Supervisor Services . Order 
No. GC28-6646. 

TRN hhhhhhhh 

Contains flags and TESTRAN indicators 
as follows: 



byte 

X • • • • • 



.1.. .. 
..1. .. 



Bit set indicates that 
both TESTRAN and decimal 
simulator programs were 
being used on a 
System/360 Model 91 
machine. 

Bit 1 set indicates that 
checkpoints were not 
taken for this step. 
Bit 2 set indicates that 
the TCB being displayed 



belonged to either a 
graphics foreground or 
the graphic job 
processor. 

...1 .... Bit 3 set indicates that 
the TCB being displayed 
was associated with a 
7 094 emulator task that 
was being run on a 
System/360 Model 85 
machine. 

....x... Bit 4 is reserved for 
future use. 

1.. Bit 5 set indicates that 

this is a time shared 
task under control of 
the TEST command 
processor. 

1. Bit 6 set indicates that 

the OLTEP functions 
require cleanup before 
abnormal termination can 
be invoked. 

.... ...x Bit 7 is reserved for 

future use. 

bytes 1-3 

The address of the control core table 
that was used by TESTRAN. 

MSS hhhhhhhh 

Main storage supervision information 
as follows: 

byte 

This byte determined roll -out 
eligibility for the job step 
associated with this TCB. 

00 in this byte indicated that the job 
step may be rolled out. 

nz (nonzero) in this byte indicated 
that the job step may not be rolled 
out. 

bytes 1-3 

These bytes contain the starting 
address of the last subpool queue 
element (SPQE). 

PK-FLG hhhhhhhh 

The storage protection key of the task 
and a series of flags. This word is 
divided into several subfields. These 
are: 



byte 
xxxx 



byte 1 
1... 



.... The storage protection 

key of the task 

represented by this TCB, 
0000 Always contain zeros. 



Bit set indicates 
thatan abnormal 
termination was in 
progress at the time the 
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1. . 



.1. 



dump was taken. 
Bit 1 set indicates that 
a normal termination was 
in progress at the time 
the dump was taken. 
Bit 2 set causes the 
Erase routine in ABEND 
to enter when ABEND is 
in control again. 



.... Bit 3 set causes the 

Purge routine in ABEND 
to enter when ABEND is 
in control again. 

1... Bit 4 set indicates that 
the Graphics Abnormal 
Termination routine was 
in control of the task 
associated with this TCB 
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at the time the dump was 
taken. Bit 7 in byte 3 
of this word must also 
be on. 

.... ,1. . Bit 5 set indicates that 
the top task in the TCB 
chain (usually the job 
step TCB) was in the 
process of being 
terminated when the dump 
was taken. 

. ..• ..1. Bit 6 set indicates that 
an abnormal dump has 
been completed. 

..... ...1 Bit 7 indicates that 

asynchronous exits could 
not be scheduled. 



byte 3 
1. 



byte 2 
1... 



Bit set indicates that 
the SYSABEND (or 
SYSUDUMP) data set for 
the job step is being 
opened. Operands of 
ABEND macro instruction 
have been saved in 
TCBCMP field. 

.1.. «... Bit 1 set indicates that 
if this is an initiator 
TCB, the second job step 
interval has expired. 

-.1. .... Bit 2 set indicates that 
for a job step TCB, the 
job step can cause 
rollout. 

...1 .... Bit 3 set indicates that 
the current task had a 
forced completion 
imposed upon it. Other 
tasks in the system 
could not have been 
performed until the 
current task had been 
completed. 

.... 1... Bit 4 set indicates that 
the job step had a 
forced completion 
imposed upon it. Other 
tasks in the job step 
could not have been 
performed until the 
present job step had 
been completed. 

.... .1.. Bit 5 set indicates that 
the SYSABEND (or 
SYSUDUMP) data set has 
been opened for the job 
step. 

.... ..1. Bit 6 set indicates that 

an EXTR exit was 
requested by an 
attaching task. 

.1 Bit 7 set indicates that 

the task associated with 
this TCB was a member of 
a time- sliced group. 



•• m JL • • • • • 



Bit set indicates that 
a PSW associated with 
the task represented by 
this TCB was in the 
supervisor state. 

.1 Bit 1 set is applicable 

to job step TCBs. 
Setting of this bit 
indicates that the job 
step had invoked 
rollouts that were still 
in effect at the time 
the dump was taken. 
Bit 2 set indicates that 
ABEND was processing in 
such a manner as to 
prevent multiple ABENDS 
from occurring in the 
dumped system. 

...1 ...x Bit 3 set indicates that 
the SYSABEND (or 
SYSUDUMP) data set is 
being opened by this 
task. (See also bit 7.) 

.... l..x Bit 4 set indicates that 
an ABDUMP was in process 
for the task associated 
with this TCB at the 
time the dump was taken. 
(See bit 7 of this 
byte. ) 

1.. Bit 5 set is applicable 

only for job step TCBs. 
With this bit set, no 
abnormal termination 
dumps could have been 
provided within the job 
step represented by this 
TCB. 

.... ..lx Bit 6 set indicates that 

a CLOSE had been issued 
during ABEND processing. 
(See bit 7 of this 
byte.) 

...x x.xl Bit 7 set, in 

conjunction with bits 3, 
4, or 6 of this byte or 
bit 4 in byte 1 of this 
word indicates that, had 
the dumped system been 
allowed to continue 
processing without 
interruption by the 
IMDSADMP dump program, a 
valid reentry to ABEND 
would have been 
effected. 



FLG hhhhhhhh 

This field displays a further series 
of flags and certain priority 
indicators. This word is divided into 
subfields as follows: 
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byte 

If any one of the flags comprising 
this byte were set at the time the 
dump was taken, the task represented 
by this TCB was considered to be 
non-dispatchable . 

1 Bit was set by ABDUMP 

.x.. .... Bit 1 is reserved for 

future use. 

..1. .... Bit 2 set indicates that 
the supply of I/O 
request queue elements 
(RQEs) had been 
exhausted. 

...x xx.. Bits 3 through 5 are 

reserved for future use. 

.... ..1. Bit 6 is applicable only 

to M65 multiprocessing 
situations. The setting 
of this bit indicates 
that the task 
represented by this TCB 
had been flagged 
non-dispatchable by one 
CPU to prevent any CPU 
from working on it. 

.... ...1 Bit 7 set indicates that 

the task associated with 
this TCB entered the 
ABEND routine while the 
data control block 
representing the 
SYSABEND data set was 
being opened for another 
task. 

byte 1 

If any one of the flags comprising 
this byte were set at the time the 
dump was taken, the task represented 
by this TCB was considered to be 
non-dispatchable . 

1 Bit set indicates that 

the task represented by 
this TCB was terminated 
prior to the time the 
dump was taken. 

.1. Bit 1 set indicates that 

the task represented by 
this TCB was a candidate 
for termination by 
ABEND. 

..1 Bit 2 set indicates that 

a routine of the task 
represented by this TCB 
issued an unconditional 
GETMAIN that could only 
have been satisfied by 
the rolling out of 
another job step. 
...1 .... Bit 3 indicates that the 
job step associated with 
this TCB was rolled out. 
.... 1... Bit 4 set indicates that 
another task was in 
system-must-complete 
status. 



.1.. 



.. ..1. 



Bit 5 set indicates that 
another task in this job 
step was in 
ste p-must-complete 
status at the time the 
dump was taken. 
Bit 6 is applicable only 
for an initiator task. 
Setting of this bit 
indicates that a request 
for a region could not 
be satisfied. 
Bit 7 is the primary 
non-dispatchability 
indicator. Setting of 
this bit indicates that 
one or more of the 
secondary 

non-dispatchability bits 
(bytes 1-3 of the DAR 
field) was set at the 
time the dump was taken. 



byte 2 

The dispatching priority limit for the 
task represented by this TCB. 

byte 3 

The dispatching priority of the task 
represented by this TCB. 

LLS hhhhhhhh 

The load list element (LLE) for the 
program that was loaded by means of 
the LOAD macro instruction. 

JLB hhhhhhhh 

The address of the data control block 
associated with the JOBLIB associated 
with the task. 

JPQ hhhhhhhh 

Contains information pertaining to a 
job step TCB as follows: 



byte 
1.. 



.XXX xxxx 



Bit set indicates that 
if the associated job 
step had been allowed to 
continue processing 
without being 
interrupted by the dump 
program, the job step 
would have been purged. 
Bits 1 through 7 are 
reserved for future use. 



bytes 1-3 

The address of the last contents 
directory entry for a job pack area 
(JPA) control queue. 

RG 0-7 and RG 8-15 

The register save area of the TCB 
being displayed. The general 
registers were stored in this area 
upon entry to the first routine 
invoked in the task. On entry to any 
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task, register 13 points to this TCB's 
register save area. This pointer is 
useful in locating the entry points of 
first routines and in tracing the save 
area chains. 



PSA hhhhhhhh 

The address of the first problem 
program save area. 

TCB hhhhhhhh 

The address of the TCB that had the 
next lowest priority on the ready 
queue at the time the dump was taken. 

TME hhhhhhhh 

The address of the timer element. 

JST hhhhhhhh 

The address of the first TCB for a job 
step. For tasks with a storage 
protection key of zero (as shown in 
the first byte of the PK-FLG field), 
this word contains the address of this 

TCB. 

NTC hhhhhhhh 

The address of the previous TCB that 
existed on the originating task's 
queue of subtask TCBs (sister). If 
this TCB was the first on the queue, 
this field contains zeros. 

OTC hhhhhhhh 

The address of the TCB representing 
the originating task (mother) . 

LTC hhhhhhhh 

The address of the last TCB that 
existed on the originating task's 
queue of subtask TCBs at the time the 
dump was taken (daughter). If this 
TCB was the last on the queue, this 
field contains zeros. 

IQE hhhhhhhh 

The address of the interruption queue 
element (IQE) that was used in 
scheduling the EXTR routine on the 
originating task. 

ECB hhhhhhhh 

The address of the event control block 
(ECB) that would have been posted by 
the supervisor's task termination 
routines had either normal or abnormal 
task termination been allowed to 
occur. 

TSPR hhhhhhhh 

byte 

This field contains flags that 
indicate the status of the time 
sharing (TSO) . Without TSO or when 
TSO has not been started, this field 
contains zeros. 



1... ...... Bit set indicates that 

this task is a time sharing 

wqS i£* 

.1.. .... Bit 1 set indicates that the 

time sharing task should be 
set non-dispatchable. This 
bit was set by the TCBSTP 
routine while the routine 
was not executing as a 
privileged program. 

...1 Bit 2 set indicates that the 

system is executing and 
requires that the time 
sharing task must not be 
interrupted by the attention 
exit or by the STATUS SVC. 

... .1 .... Bit 3 set indicates that a 
terminal I/O purge is 
required. 

.... xxxx Bits 4 through 7 are 

reserved for future use. 

byte 1 

This field contains the number of SET 
STATUS starts required to make this 
time sharing task dispatchable. 

byte 2 

This field contains the limit priority 
of the time sharing task. 

byte 3 

This field contains the dispatching 
priority of the time sharing task. 

D-PQE hhhhhhhh 

The address of the region dummy 
partition queue element minus 8 
(DPQE-8 ) . 

SOS hhhhhhhh 

The address of an allocated queue 
element (AQE) which contains the 
amount of available bytes assigned to 
this task in the system queue area 
(SQA), and a pointer to the next AQE 
for this task. 

STA hhhhhhhh 

Internal STAE routine flags and the 
address of the STAE control block that 
was in effect at the time the dump was 
taken. 

TCT hhhhhhhh 

This word contains information 
pertaining to the dumped system's 
timing control table (TCT) . The TCT 
field is divided into the following 
two subfields: 

byte 

Reserved for future use. 
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bytes 1-3 

If the system management facilities 
option was present in the dumped 
system, these bytes contain the 
address of the dumped system* s timing 
control table. 

USR hhhhhhhh 

This word is available to the user of 
the dumped system- It contains any 
information placed in it by the user. 

DAR hhhhhhhh 

The contents of this field were used 
by the damage assessment routines 
(DAR). Certain subfields displayed in 
this word were also used to control 
the dispatchability of the dumped 
task. The DAR field is divided into 
the following subfields: 

byte 

The first byte of the DAR field 
contains DAR flags. These flags are 
as follows: 

1. Bit set indicates that 

primary DAR recursion 
occurred in the dumped 
system. The damage 
assessment routine 
failed while writing a 
main storage image dump. 
.1.. ..... Bit 1 set indicates that 

secondary DAR recursion 
occurred in the dumped 
system. The damage 
assessment routine 
failed while attempting 
to reinstate a failing 
region or partition. 
..xx . .., Bits 2 and 3 are 

reserved for future use. 
.... 1... Bit 4 set indicates that 

the system error task is 
failing. The DAR dump 
should not request any 
error recovery procedure 
(ERP) processing. 
.... .xx. Bits 5 and 6 are 

reserved for future use. 
.... ...1 Bit 7 set indicates that 

an SVC dump is executing 
for this task, 
byte 1 

Bytes 1 through 3 of the DAR field are 
used to store secondary 
non-dispatchability flags. If any of 
the flag bits in this subfield were 
set, the primary non-dispatchability 
bit (the last bit in the FLG field) 
will also have been non- dispatch able. 
The bit settings that may appear in 
byte 1 are as follows: 

xx Bits and 1 are set by 

the damage assessment 
routines. Their 
meanings are: 



.1.. .. 



. .xx 



..1., 



...1 



X. 



.1.. 



..XX 



Bit set indicates that 
the task represented by 
this TCB is temporarily 
non-dispatchable . 
Bit 1 set indicates that 
the task represented by 
this TCB is permanently 
non-dis patchable . 
Bits 2 and 3 are 
recovery management 
support and system error 
recovery flags. Their 
meanings are: 
Bit 2 set indicates that 
the task represented by 
this TCB is temporarily 
non-dispatchable. 
Bit 3 set indicates that 
the task represented by 
the TCB is permanently 
non-dis patchable . 
Bit 4 is reserved for 
future use. 

Bit 5 set indicates that 
this task is temporarily 
non-dispatchable. Timer 
services have been 
requested and the 
time-of-day clock is 
still inoperative. 
Bits 6 and 7 are 
reserved for future use. 



byte 2 

The bit settings for byte 2 are as 
follows: 



x. . . 

...1 



1. 



.1. 



. .xx 



Bit is reserved for 

future use. 

Bit 1 set indicates that 

this task has been 

stopped by a STATUS 

stop. 

Bit 2 set indicates that 

task is 

non-dispatchable. An 

SVC dump is executing 

for another task. 

Bit 3 set indicates that 

this task is being 

swapped out by the time 

sharing (TSO) . 

Bit 4 set indicates that 

this task is in an input 

wait state. 

Bit 5 set indicates that 

this task is in an 

output wait state. 

Bits 6 and 7 are 

reserved for future use. 



byte 3 

Reserved for future use. 

RES hhhhhhhh 

Reserved for future use. 
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JSCB hhhhhhhh 

The address of the job step control 
block. 

RES hhhhhhhh 

Reserved for future use. 

IOBRC hhhhhhhh 

Contains the address of the IOB 
restore chain for I/O quiesced by 
end-of-task. 

MVT ACTIVE REQUEST BLOCK (RB) FORMATTING ;. 
Request blocks (RBs) were used by the lines 
at the top of the dump page and in the 
preceding TCB display, are listed in the 
portion of the dump listing labeled "ACTIVE 
RBS." Information on each RB associated 
with the task is formatted as shown below; 

PRB 

IRB hhhhhh 

SVRB 

SIRB 

Each RB display is preceded by a field 
that indicates the type and address of 
the RB being displayed. The four 
types of RBs that may be displayed 
under an MVT task are; 



PRB 



IRB 



SVRB 



SIRB 



program request block 

interruption request block 

supervisor request block (SVRBs 
may be divided into two 
categories; type 2 for resident 
routines and type 3 or 4 for 
transient routines) 

system interruption request 
block. 



The type acronym for each RB is 
displayed in the first portion of the 
field. The starting address of the 
indicated request block appears in the 
last portion of the field. The 
contents of certain fields in the body 
of the formatted display are dependent 
upon the type of rb being displayed. 
Variations in display field usage are 
noted in the descriptions of the 
fields in which they occur. 

RESV 

TAB-LN hhhhhhhh 

FL-PSA 

This field shows both the function and 
the first word of the request block 
being displayed. The meanings of the 
function indicators and the values 
that follow them are: 



RESV 



indicates that the request block 
is either a PRB or an SVRB for 



resident routines. The first 
word of these particular RBs is 
reserved for future use and 
contains zeros. 



TAB-LN 

indicates that the request block 
being displayed is used as an 
SVRB for transient routines. The 
value field is divided into two 
subfields of two bytes each. The 
first two bytes show the 
displacement of the entry point 
of the module represented by this 
SVRB from the beginning of the 
transient area control table 
(TACT). The second subfield 
shows the length, in bytes, of 
the SVC routine. 

FL-PSA 

indicates that the RB being 
displayed is an IRB. The value 
portion of this field is divided 
into two subfields. The first 
subfield has a length of one byte 
and contains indicators for the 
timer routines. When there were 
no timer routines, this field 
contains zeros. The timer 
routine indicators set at the 
time the dump was taken are shown 
as: 

1 indicates that the 

timer element was not 

on queue. 
.1.. .... indicates that the 

local time-of-day 

option was used. 
..00 .... indicates that the 

time interval was 

requested in timer 

units. 
. . 01 .... indicates that the 

time interval was 

requested in binary 

units. 
..11 .... indicates that the 

time interval was 

requested in decimal 

form. 
.... 1. . . indicates that the 

time interval had 

expired. 
000 indicates a task 

request 
100 indicates a task 

request with an exit 

specified. 
001 indicates a wait 

request. 
.... .011 indicates a real 

request. 
.... .111 indicates a real 

request with an exit 

specified. 
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The second subfield is three 
bytes long and contains the 
starting address of the problem 
program register save area (PSA) . 

APSW hhhhhhhh 

The APSW field displays information 
pertaining to the program status word 
that was active at the time the dump 
was taken. The functional variations 
associated with the usage of this 
field are: 

• PRBs being formatted contain the 

right half (bytes 4 through 7) of 
the problem program^ PSW when an 
ABTERM interruption occurred. 

• IRBs, SIRBs, and SVRBs for resident 

routines use this field to display 
the right half (bytes 4 through 7) 
of the PSW that was active, in the 
dumped system, during the 
execution of an ABEND or ABTERM 
routine. If no ABEND or ABTERM 
routine was envoked in the dumped 
system, this field contains zeros. 

• SVRBs for transient routines use 

this field in much the same way as 
SVRBs for resident routines. If 
an ABEND or ABTERM routine was 
invoked in the dumped system, 
bytes <* through 7 of the 
associated PSW are displayed in 
this field. If an ABEND or ABTERM 
routine was not invoked, this 
field contains the last four 
characters of the name of the 
requested routine. (The last two 
characters of the name represent 
the SVC number. ) 

WC-SZ-STAB hhhhhhhh 

This field contains information 
pertaining to wait conditions, request 
block sizes, and RB status and 
attribute characteristics. This field 
is divided into three subfields, as 
follows : 

byte 

The wait count that was in effect at 
the time of the dump. 

byte 1 

The size of this request block. This 
RB size is expressed as the number of 
doublewords comprising the block. 

byte 2 

The last two bytes of the WC-SZ-STAB 
field contain bit settings that 
reflect the status and attributes of 
the request block. The settings that 
may appear in byte 2 are: 



xx. 



Bits and 1 indicate 
the type of RB being 
displayed. The possible 



settings for these two 
bits and their meanings 
are : 

00 This is a program 

request block (PRB). 

01 This is an interrupt 

request block (IRB). 

10 This is a system 

interrupt request block 
(SIRB). 

11.. .... This is a supervisor 

request block (SVRB) . 

..x. x. xx Bits 2, 4, 6 and 7 are 
reserved for future use. 

...1 .... Bit 3 set indicates that 
this request block is an 
SVRB for a transient 
routine. 

1. . Bit 5 is applicable only 

if the request block 
being displayed is an 
SVRB. If this bit is 
set, a checkpoint could 
have been taken in a 
user exit from the SVC 
routine associated with 
this RB. 
byte 3 

The last byte of the WC-SZ-STAB field 
contains more status and attribute 
flags. The possible settings for this 
subfield and their meanings are: 

1 Bit set indicates that 

the WT-LNK field in this 
RB display, contains in 
its last three bytes, 
the address of the TCB 
to which this request 
block is linked. 

.1.. .... Bit 1 applies only to 

IRBs and SIRBs. If this 
bit is set, the 
indication is that at 
the time the dump was 
taken, the program 
associated with this RB 
was active. 

. .x Bit 2 is reserved for 

future use. 

...1 .... Bit 3 is applicable only 
to IRBs. The setting of 
this bit is an 
indication that the IRB 
was associated with an 
ETXR exit routine. 

.... xx.. Bits H and 5 concern 
interruption queue 
elements (IQEs) and 
request queue elements 
(RQEs). This flag is 
used as follows: 

.... 00.. This setting indicates 
that the request queue 
element was not to be 
returned to the free 
list when the exit was 
taken. 
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01* . This setting indicates 
that the IRB had queue 
elements for 
asynchronously executed 
routines that were RQEs. 
This setting is 
applicable only if the 
RB being displayed is an 
IRB. 

10.. This setting indicates 
that the IQE was not to 
have been returned at 
EXIT. 

11. . This setting is 

applicable only to IRBs. 
If this setting appears, 
the indication is that 
the IRB had queue 
elements for 
asynchronously executed 
routines that were IQEs. 

..1. Bit 6 set indicates that 
request block storage 
could be freed at the 
time of exit. 

...x Bit 7 indicates request 
wait conditions. The 
meanings of the two 
possible settings for 
this bit are: 

... Bit 7 not set indicates 
that the request had to 
wait for a single event 
or all of a number of 
events. 

.... .1 Bit 7 set indicates that 
the request had to wait 
for a number of events. 
This number of events 
was less than the total 
number of events that 
were waiting. 



EPA 



.... .1.. indicates that a SYNC 

macro instruction was 

requested. 
.... ..1. indicates that an 

XCTL macro 

instruction was 

requested. 
.... ...1 indicates that a LOAD 

macro instruction was 

requested. 

The second subfield is three 
bytes long and contains the 
address of the contents directory 
entry (CDE) representing the 
module that this request block 
was associated with. 



The request block being displayed 
is an IRB. The value field 
contains the entry point address 
of a routine that was 
asynchronously executed. 



TQN 

The request block being displayed 
represents a transient routine 
SVRB. The value field contains 
the address of the next request 
block that was on the queue of 
transient routines. 

PSW hhhhhhhh hhhhhhhh 

The resume program status word. This 
PSW represents the status of the 
program represented by the RB being 
displayed when a new RB was created. 
Had the dumped system been allowed to 
continue processing without being 
interrupted by the dump program, 
operation would have resumed on this 
PSW. 



FL-CDE 

EPA 

TQN 



hhhhhhhh 



This field shows both the function and 
the fourth word of the request block 
being displayed. The meaning of the 
function indicator and the value 
following it is given below: 

FL-CDE 

the request block being displayed 
is either a PRB or an SVRB for a 
resident routine. The value 
field is divided into two 
elements. The first subfield has 
a length of one byte and contains 
control flag settings. 

These control flags are as 
follows : 



XXXX X . . . 



Bits through 4 are 
reserved for future 



use. 



Q/TTR hhhhhhhh 

This word is used to display various 
data, depending upon the type of 
request block being displayed. Usage 
of the Q/TTR value field is used by 
each type of request block as follows : 

• PRBs and SVRBs that represented 
resident routines do not use this 
field; the first byte always 
contains zeros. Bytes 1 through 3 
of the field show the address of a 
request block that requested the use 
of the same serially reusable 
program. 

• IRBs utilize this field in one of 
two ways, to show either the 
three-byte link-field segment or the 
two-byte link-field segment, 
depending upon the IRB usage. The 
three -byte link -fie Id segment 
appears in the Q/TTR value field as 
follows: 
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byte 

Contains a count of the number of 
requests for the same exit (ETXR). 
This use count is utilized by the 
ATTACH macro instruction. 

byte 1-3 

Contains the starting address of 
the queue of interruption queue 
elements (IQEs). 

Alternately, the Q/TTR value field 
may be formatted to show the 
two-byte link-field segment. In 
this instance, the field is used 
thusly: 

byte 0-1 

Reserved for future use. 

bytes 2-3 

The starting address of the queue 
of request queue elements (RQEs). 

SVRBs that represented transient 
routines display two data elements 
in this field. The first subfield 
has a length of one byte and shows 
the number of requests if the 
transient routine was overlaid. The 
last three bytes of the Q/TTR field 
contain the relative direct access 
device address for the associated 
supervisor routine in the form TTR. 



WT-LNK hhhhhhhh 

This field displays information 
pertaining to wait counts and request 
block linkages. In the case of a 
transient SVC, if this field contains 
x'FF 1 , either the routine represented 
by the SVRB is currently being brought 
into the transient area, or this 
routine has been displaced in the 
transient area by a routine requested 
by a higher priority task. To tell 
what has happened, compare the APSW 
and NM field contents as described 
under NM below. This field is divided 
into two subfields, one with a length 
of one byte and the other with a 
length of three bytes. These 
subfields show the following: 

byte 

The number of requests that were 
pending at the time the dump was taken 
(wait count). 

byte 1-3 

The address of the next request block 
on the RB queue. In the last RB on 
the queue, this field contains the 
address of the task control block 
(TCB). 



NM cccccccc 

The eight character name of the load 
module represented by the request 
block being displayed with a possible 
exception for transient SVRBs. 

If byte of the WT-LNK field contains 
x'FF* , it is possible that the module 
represented by this SVRB has been 
overlaid in the transient area by a 
module requested by a higher priority 
task. Compare the APSW field, 
(providing it contains the four 
low-order bytes of a module name) with 
the last four characters (the 
hexadecimal should be translated to 
EBCDIC) of the module name in the NM 
field. No match indicates the user of 
the transient area has been pre-empted 
by a higher priority task. NM 
therefore represents the module 
currently in the transient area, not 
the module represented by this SVRB. 

If a match results, NM correctly 
identifies the module name requested 
by this SVRB. 

EPA hhhhhh 

The address of the entry point of the 
module named in the NM field of this 
RB display. 

STA hhhhhh 

The starting address of the module 
identified in the NM field of this 
RB* s display. 

LN hhhhhh 

The length, in bytes, of the load 
module that is represented by this 
request block. 

ATR1 hh 

This one byte field displays the 
attributes of the described module. 
These attributes are taken from the 
contents directory entry associated 
with the module. The meanings of the 
attribute flag settings are given 
below: 



1. 



.1, 



,1. 



.1 



Bit set indicates that 
the module was resident 
in the link pack area. 
Bit 1 set indicates that 
at the time the dump was 
taken, the module 
represented by this 
request block was in the 
process of being 
fetched. 

Bit 2 set indicates that 
the module was 
reenterable. 

Bit 3 set indicates that 
the module was serially 
reusable. 
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.. 1««. Bit 4 set indicates that 
the module could not 
have been reused. This 
flag setting is not 
applicable if either bit 
2 or 3 is set. 

, . . 1. . Bit 5 set indicates that 
the contents directory 
entry associated with 
this module reflects the 
use of an alias name. 
This information applies 
only to minor CDEs. 

, . ..1. Bit 6 set indicates that 
the module was in the 
job pack area. 

,. ...1 Bit 7 set indicates that 
the module was 
considered not 
only- loadabl e . 



MVT MAIN STORAGE INFORMATION : Each task 
operating under the MVT option of the 
operating system was dynamically assigned a 
region of main storage that consisted of 
one or more 2K-byte subpool areas. To keep 
track of main storage allocations, the MVT 
supervisor maintained a partition queue 
associated with each region. Composed of 
partition queue elements (PQEs), and 
residing in the system queue area, this 
partition queue was connected to the TCBs 
for each task in a job step through a dummy 
partition queue element (DPQE). 

Information on the areas of main storage 
allocated to each task, is presented to the 
user in a separate portion of each task's 
dump listing headed "MAIN STORAGE. " This 
main storage information is formatted as 
shown below s 

D-PQE hhhhhhhh 

The address minus eight bytes of the 
dummy partition queue element (DPQE- 8) 
connecting the partition queue to this 
task's TCB. 

FIRST hhhhhhhh 

The starting address of the first 
partition queue element (PQJB) on this 
region 1 s partition queue. 

LAST hhhhhhhh 

The starting address of the last PQE 
on the partition queue. 

PQE hhhhhh 

The starting address of one of the 
partition queue elements on the 
partition queue bounded by the 
addresses given on the line above. 

FFB hhhhhhhh 

The starting address of the first free 
block queue element (FBQE) on the free 
block queue associated with this PQE. 



If no FBQEs exist, this field contains 
the address of the PQE being displayed 

LFB hhhhhhhh 

The starting address of the last free 
block queue element (FBQE) on the free 
block queue associated with this PQE. 
If no FBQEs exist, this field shows 
the starting address of this PQE. 

NPQ hhhhhhhh 

The starting address of the next 
partition queue element on the 
partition queue, if the PQE being 
displayed was the last PQE on the 
queue, this field contains zeros. 

PPQ hhhhhhhh 

The starting address of the partition 
queue element on the partition queue 
that preceded this PQE. If this PQE 
was the first on the queue, this field 
contains zeros. 

TCB hhhhhhhh 

The starting address of the TCB of the 
job step to which the described region 
is assigned. If this field contains 
zeros, the indication is that the area 
of main storage was obtained from 
unassigned free space. 

RSI hhhhhhhh 

The size of the region being 
described. This number is a multiple 
of 2K (2048). 

RAD hhhhhhhh 

The starting address of the region 
being described by this PQE. 

FLG hhh 

The FLG field shows the settings of 
several PQE flags whose meanings are 
given below: 

x Bit indicates region 

ownership. The meanings 
of the settings are: 

indicates that the space 

described by this PQE 
was owned by the 
associated task. 

1., indicates that the space 

described by this PQE 
was borrowed. 

.1-. .... The setting of bit 1 is 
meaningful only if bit 
was not set. If this 
bit is set and bit is 
not set, the indication 
is that the region had 
been rolled out. 

..1. «... Bit 2 set indicates that 
the region described by 
this PQE was borrowed by 
another task. 

,...x xxxx Bits 3 through 7 are 

reserved for future use. 
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MVT LOAD LIST FORMATTING : A load list was 
maintained by the dumped system's 
supervisor in order to keep track of the 
load modules that were in main storage and 
the area of main storage each occupied. 
The load list maintained by a system 
operating under the MVT option of the 
operating system contained a series of load 
list elements (LLEs) , each of which was 
associated with a particular load module 
through the use of a control block called a 
contents directory entry (CDE). A 
formatted listing of the dumped system* s 
MVT load list appears as follows: 



CDE hhhhhh 

The starting address of the contents 
directory entry associated with this 
load list item. 

NM cccccccc 

The eight -character name of the entry 
point to the load module represented 
by this entry. 

USE hh 

The count of the number of uses 
(through the ATTACH, LINK and XCTL 
macro instructions) of the load 
module, and the number of times a LOAD 
macro instruction was issued for the 
module. 

RESP hh 

The responsibility count contained in 
the load list entry associated with 
the load module. This count indicates 
the number of requests made by the 
LOAD macro instruction for the 
indicated load module. This count was 
decremented by one for each occurrence 
of the DELETE macro instruction. 



.... 1... Bit U set indicates that 
the load module could 
not have been reused. 
This flag setting is not 
applicable if either bit 
2 or 3 is set. 

1.. Bit 5 set indicates that 

the contents directory 
entry associated with 
this load module 
reflects the use of an 
alias name. If this bit 
is set, this line of the 
load list display 
reflects information 
taken from a minor CDE. 

.... ..1. Bit 6 set indicates that 

the load module was in 
the job pack area. 

1 Bit 7 set indicates that 

the load module was 
considered not 
only-loadable. 

EPA hhhhhh 

The address of the entry point of the 
load module named in the NM field of 
this load list display line. 



STA hhhhhh 

This field contains the starting 
address of the load module identified 
in the NM field of this load list 
display line. 

LN hhhhhh 

The LN field supplies the user with 
the length, in bytes, of the load 
module represented by this load list 
entry (LLE). 



ATR1 hh 

The attributes of the load module 
described in this load list entry. 
These attributes are taken from the 
contents directory entry associated 
with the module. The meanings of the 
attribute flag settings are given 
below: 



1. 



1. 



.1 



Bit set indicates that 
the module was resident 
in the link pack area. 
Bit 1 set indicates that 
at the time the dump was 
taken, the load module 
represented by this load 
list element was in the 
process of being loaded. 
Bit 2 set indicates that 
the load module was 
reenterable. 

Bit 3 set indicates that 
the load module was 
serially reusable. 



MVT JOB PACK QUEUE FORMAT : A job pack area 
control queue (JPACQ) exists for each job 
step in the dumped system that used a 
program not in the link pack area. The job 
pack queue, like the link pack area, is 
made up of contents directory entries 
(CDEs) . This area describes routines in a 
job step region that were brought into main 
storage by contents supervision routines to 
perform a task in the job step. The 
IMDPRDMP program displays the contents of 
the dumped MVT system's job pack queue as 
follows: 

CDE hhhhhh 

The starting address of the contents 
directory entry associated with this 
job pack queue element. 



NM cccccccc 

The eight-character name of the entry 
point to the load module represented 
by this entry. 
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USE hh 

The count of the number of uses 
(through the ATTACH, LINK and XCTL 
macro instructions) of the load 
module, and the number of times a LOAD 
macro instruction was issued for the 
module. 

RESP NA 

This responsibility count field is 
flagged 'NA* to indicate that the 
information is not applicable to 
modules displayed in the job pack 
queue. 

ATR1 hh 

The attributes of the load module 
described in this job pack queue 
entry. These attributes are taken 
from the contents directory entry 
associated with the module. The 
meanings of the attribute flag 
settings ares 

1. Bit set indicates that 

the module was resident 
in the link pack area. 

.1.. .... Bit 1 set indicates that 

at the time the dump was 
taken, the load module 
represented by this job 
pack queue entry was in 
the process of being 
loaded. 

.<1. .... Bit 2 set indicates that 
the load module was 
reenterable. 

...1 .«.. Bit 3 set indicates that 
the load module was 
serially reusable. 

.... 1... Bit 4 set indicates that 
the load module could 
not have been reused. 
This flag setting is not 
applicable if either bit 
2 or 3 is set. 

1. . Bit 5 set indicates that 

the contents directory 
entry associated with 
this load module 
reflects the use of an 
alias name. If this bit 
is set, this line of the 
job pack queue display 
reflects information 
taken from a minor CDE. 

1. Bit 6 set indicates that 

the load module was in 
the job pack queue area. 

1 Bit 7 set indicates that 

the load module was 
considered not 
only- loadable. 

EPA hhhhhh 

The address of the entry point of the 
load module named in the NM field of 
this job pack queue entry display 
line. 



STA hhhhhh 

This field contains the starting 
address of the load module identified 
in the NM field of this job pack queue 
entry display line. 

LN hhhhhh 

The LN field supplies the user with 
the length, in bytes, of the load 
module represented by this job pack 
queue entry. 

MVT DATA EXTENT BLOCK (DEB) FORMATTING : 
Data extent blocks (DEBs), describing a 
data set's external storage requirements, 
were queued to those task control blocks 
(TCBs) that represented tasks requiring 
auxiliary storage input/ out put processing. 
External storage information, taken from 
each DEB, is formatted as shown below: 

DEB hhhhhh 

The starting address of the basic 
section of the DEB being displayed. 

APPENDAGES 

The word "appendages" informs the user 
that the five named fields on this 
line contain information taken from 
the appendage vector table preceding 
the DEB being displayed. The named 
fields appearing on the rest of this 
line are: 

END OF EXT hhhhhh 

The entry point of the end-of -extent 
appendage routine. 

SIO hhhhhh 

The entry point of the start I/O 
appendage routine. 

PCI hhhhhh 

The entry point of the 
program-controlled-interruption 
appendage routine. 

CH END hhhhhh 

The entry point of the channel-end 
appendage routine. 

AB END hhhhhh 

The entry point of the abnormal-end 
appendage routine. 

PFX hhhhhhhh hhhhhhhh hhhhhhhh 

The second line of a DEB display 
contains information taken from the 
prefix section of the DEB being 
displayed. The area is subdivided as 
follows: 

byte 

The first byte of the prefix area 
contain the contents of the I/O 
support work area. This area is used 
only by DEBs dealing with direct 
access storage devices. 



IMDPRDMP Output Formatting: MVT — DEBs 87 



bytes 1-7 

The next seven bytes of the DEB prefix 

section are used by DEBs associated 

with direct access storage device 

functions- This subfield displays the 

data set control block's (DSCB) 

address used by I/O support. The 

address is expressed in the following 

formats 

bytes 1 and 2 the bin 

bytes 3 and 4 

bytes 5 and 6 



(cell) number, 
the cylinder address, 
the track address. 



byte 7 



the record number. 



bytes 8-11 

The third word of the PFX field 
contains the data control block (DCB) 
modification mask that was used by I/O 
support. 

byte 12 

The length of the DEB in doublewords . 

bytes 13-15 

The remainder of the DEB prefix 
section is reserved for future use. 

TCB hhhhhh 

This field marks the beginning of the 
basic section of the data extent 
block. The TCB field is divided into 
two subfields as follows: 

byte 

The number of subroutines for which a 
LOAD macro instruction was issued 
during the execution of the OPEN 
executor routines. 

bytes 1-3 

The starting address of the task 
control block to which this DEB was 
enqueued. 

NDEB hhhhhh 

The NDEB field is also used to display 
two data elements. It is subfielded 
as follows: 

byte 

The overall length of a data extent 
block includes the length of a 
variable length access method 
dependent section. The first byte of 
the NDEB field, expresses the length 
of the access method dependent section 
in bytes. If the access method was 
BDAM, this indicator is expressed as a 
number of fullwords. 

bytes 1-3 

The last portion of the NDEB field 
displays the starting address of the 
basic section of the next DEB on the 
task's queue. If this DEB was the 
last on the queue, the contents of 
this field are the starting address of 
the TCB that enqueued this DEB. 



ASYN hhhhhhhh 

This field contains fata set status 
flags and the address of the 
associated IRB. This field is used as 
follows: 

byte 

The first byte of the ASYN field 
contains data set status flags. These 
flags have the following meanings: 



01.. 
10.. 

11.. 
..1. 

...1 



1. 



.1. 






Bits and 1 indicate 
the data set's 
disposition. The 
possible settings are: 
This setting indicates 
that the disposition was 
OLD. 

This setting indicates 
that the disposition of 
the data set was MOD 
(modify) . 

This setting indicates 
that the disposition was 
NEW. 

Bit 2 set indicates that 
an end-of-volume (EOV) 
or end-of-file (EOF) 
condition had been 
encountered. 

The setting of bit 3 has 
one of two meanings 
depending upon the 
external storage medium. 
For disk this indicator 
reflects a release of 
unused external storage. 
For tape, the meaning of 
this indicator is that 
an emulator tape with 
second generation format 
was being used. 
Bit 4 set is a data 
control block (DCB) 
modification indicator. 
Bit 5 set has two 
meanings, depending upon 
the auxiliary storage 
recording medium. For 
disk, the setting of bit 
5 indicates that a split 
cylinder was 
encountered. For tape, 
this flag indicates that 
an emulator tape with 
possible mixed parity 
records was used. 
Bit 6 set indicates the 
use of nonstandard 
labels. 

Bit 7 set indicates that 
reduced error recovery 
procedures were used on 
magnetic tapes 
containing the data set 
represented by this DEB. 
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bytes 1-3 

The last portion of the ASYN field 
shows the starting address of the IRB 
that was associated with asynchronous 
appendage exit scheduling. 

SPRG hhhhhhhh 

This field contains information on I/O 
processing methods and the system 
PURGE routine. The usage of this 
field is as follows: 

byte 

The first byte of this field contain 
flags that indicate the method of 
input/output processing and the 
disposition of the data set that was 
to have been performed when an end-of- 
volume condition occurred. These flag 
settings are: 



1... 



.0.. 
. .xx 



..01 
..11 






0000 

1111 

0011 
0111 
0001 
0x00 



Bit was set by ABEND. 

The setting of this bit 

indicates that the data 

set associated with this 

DEB was a SYSABEND or 

SYSUDUMP data set. 

Bit 1 is always zero. 

Bits 2 and 3 show the 

e nd- of- vol ume 

disposition procedure. 

The values for this flag 

are: 

REREAD 

LEAVE 

The last half of this 

byte contains flags that 

indicate the type of 

input/output processing 

that was performed on 

the data set represented 

by this DEB. The values 

for this flag are: 

INPUT 

OUTPUT 

INOUT 

OUTIN 

RDBACK 

UPDAT 



byte 1 

The quiesce count. The byte is 
associated with the system PURGE 
routines (SVC 16) and indicates the 
number of auxiliary storage devices 
that were executing the user's channel 
programs. 

bytes 2-3 

Reserved for future use. 

UPRG hhhhhhhh 

The UPRG field contains extent 
information and data used by the 
user's purge routines. This field is 
divided into the following two 
subfields: 



byte 

The number of extents that were 
specified in the DSCBs associated with 
this DEB. 

bytes 1-3 

The address of the first input/output 
block (IOB) in the user's purge chain. 

PLST hhhhhhhh 

Task priority and supervisor purge 
information are contained in this 
field. This field is formatted as 
follows: 

byte 

The priority of the task under which 
this DEB was enqueued. 

bytes 1-3 

The starting address of a parameter 
list that was used to locate the purge 
event control block (ECB) for a 
supervisor purge request. 

DCB hhhhhhhh 

The DCB field contains three data 
elements. These are displayed in the 
format given below: 



byte 
xxxx 



.... The storage protection 
key that was associated 
with the task under 
which this DEB was 
enqueued. 

1111 A hexadecimal *F' in 

bits 4 through 7 of this 
field identify this 
control block as a data 
extent block (DEB) . 



bytes 1-3 

The starting address of the data 
control block (DCB) that was 
associated with this DEB. 

AVT hhhhhhhh 

The AVT field displays two DEB data 
elements and is subfielded as follows: 

byte 

The DEB extent scale that is used to 
determine the size of the device 
dependent section of this DEB. For 
direct access devices, a <* is 
displayed in this subfield. For a 
nondirect access device or a 
communication device, a 2 is 
displayed. 

bytes 1-3 

In most cases the last portion of the 
AVT field shows the starting address 
of the appendage vector table 
preceding this DEB. This table of 
appendage routine addresses appears on 
the first line of this DEB's display. 
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OP-UCB hhhhhhh 

The contents of this field have 
meaning only when the DEB being 
displayed describes a data set that 
was assigned to a unit record or 
magnetic tape device. This 
information is formatted from the 
device dependent section of the DEB. 
The OP-UCB field is subfielded as 
follows : 

byte 

This first subf ield is applicable only 
to data sets assigned to magnetic tape 
devices and shows the SET MODE 
operation code. For a data set that 
was assigned to a unit record device, 
this subfield is reserved. 

bytes 1-3 

The starting address of the unit 
control block (UCB) associated with 
the data set described by the DEB 
being displayed. 

The following four fields are present only 
for data sets assigned to the IBM 3525 Card 
Punch for multi-function. The information 
is formatted as shown below: 

UCB hhhhhhhh 

byte 

The device modifier field (not used 
for the 3525) . 

bytes 1-3 

The starting address of the unit 
control block (UCB) associated with 
the data set described by the DEB 
being displayed. 

RDRDCB hhhhhhhh 

The starting address of the data 
control block (DCB) for the read 
associated data set. 

PCHDCB hhhhhhhh 

The starting address of the data 
control block (DCB) for the punch 
associated data set. 

WTRDCB hhhhhhhh 

The starting address of the data 
control block (DCB) xor the print 
associated data set. 

Tne final portion of a DEB display shows 
information pertaining to a data set that 
was assigned to a direct access device. 
This information,, taken from the DEB's 
device dependent section, is arranged in 
columnar format with a line for each 
extent. The information is formatted as 
shown below: 

FM-UCB hhhhhhhh 

The first column displays two data 
elements and is formatted as follows: 



byte 

The device modifier showing the file 
mask. 

bytes 1-3 

The starting address of the unit 
control block (UCB) that was 
associated with the data extent. 

START hhhhhhhh 

The address of the beginning of the 
direct access device extent. The 
first four characters represent the 
cylinder address and the last four 
characters represent the track 
address . 

END hhhhhhhh 

The address of the end of the data 
extent. Cylinder and track references 
are formatted as in the extent 
beginning address, described above. 

TRKS hhhh 

The number of direct access tracks 
bounded by the starting and ending 
addresses shown in the previous two 
columns. 

MVT TASK INPUT/OUTPUT TABLE (TIOT) 
FORMATTING : A task input output table 
(TIOT) was constructed for each task in the 
dumped system by MVT job management 
routines. Residing in the system queue 
area, this table contained primary pointers 
to control blocks used by I/O support 
routines. As the functions of several TIOT 
fields were dependent upon the state of 
associated external storage devices, 
multiple definitions may apply. The TIOT 
that was constructed in an MVT system is 
formatted as shown. 

TIOT hhhhhh 

The starting address of the task 
input/output table being displayed. 

JOB cccccccc 

The eight-character name of the job 
for which this TIOT was constructed. 

STEP cccccccc 

The eight-character name specified in 
the label field of the EXEC JCL 
statement associated with this job 
step. 

PROC cccccccc 

If the job step for which this TIOT 
was constructed was invoked from a 
cataloged procedure, the procedure 
name, as contained in the EXEC JCL 
statement, is displayed in this field. 

Each data set associated with the indicated 
task is represented by a separate DD entry 
that is included in the TIOT. Each TIOT 
entry is displayed on a separate line in 
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columnar format. The use and meaning of 
each column is given below: 

OFFSET hhhh 

The offset of this DD entry from the 
beginning of the TIOT in hexadecimal. 

LN-STA hhhhhhhh 

Four bytes of length and status 
information, described below: 

byte 

The total length (including all device 
entries) in bytes of the DD entry 
being displayed on this line. 

byte 1 

Status byte A, one of three status 
bytes in a TIOT entry. The meanings 
of the status byte settings are: 

x... .x.. Bits and 5 indicate 
the tape label 
processing that was to 
have been performed. 
The meanings of the 
settings are: 
Nonlabeled tape or an 
indication to bypass 
label processing. 
Standard labels and 
standard user labels. 
Nonstandard labels. 
The setting of status 
bit 1 has two meanings, 
depending upon the 
processing phase that 
had been reached at the 
time the system was 
dumped. During 
allocation processing, 
the setting of this bit 
indicates that this 
entry represents a split 
cylinder primary space 
allocation DD. If the 
dump was taken during 
step termination 
processing, the setting 
of this bit indicated 
that no unallocation of 
space was necessary. 

. .1. .... The setting of status 
bit 2 work& under the 
same philosophy as 
status bit 1. During 
allocation processing, 
the setting of this bit 
indicates that this 
entry represents a split 
cylinder secondary opace 
allocation DD. If the 
dump was taken during 
step termination 
processing, the 
indication was one of 
rewinding with no 
unload. 



..1 



1. 



0., 



0... .1. 

1... .0. 
.1 



,1. 



Bit 3 set indicates that 
this DD entry represents 
a JOBLIB. 

Bit 4 set indicates that 
direct access device 
space management was 
deemed necessary. 
The setting of bit 6 
specifies that the tape 
volume was to have been 
rewound and unloaded* 
The setting of bit 7 
specifies that the tape 
volume was to have been 
rewound. 



byte 2 

The third byte of this column has 
meaning only during the allocation 
phase. This displays the number of 
devices that were requested by the 
data set represented by the TIOT entry 
displayed on this line. 



byte 3 

The last byte of the LN-STA field 
displays a TIOT field that had meaning 
at two points during the processing of 
this task. During the allocation 
process, this field contained a link 
to the appropriate prime split, unit 
affinity, volume affinity or 
suballocate TIOT entry. After CLOSE 
processing, this byte was used thusly: 



1. 



.xxx xxxx 



The setting of bit 
indicates that the data 
set represented by this 
DD entry was a SYSOUT 
data set that contained 
data. 

Bits 1 through 7 are 
reserved for future use. 



DDNAME CCCCCCCC 

The eight-character DD name associated 
with the TIOT entry being displayed. 



TTR-STC hhhhhhhh 

The first three bytes of this column 
display the relative track address 
(TTR) of the job file control block 
(JFCB) associated with this entry. 



STB-UCB hhhhhhhh 

The last column in a TIOT display 
contains information taken from the 
one -word device entries that are 
appended to each TIOT entry. One TIOT 
device entry exists for each allocated 
device. This display field shows this 
information in the following format: 
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byte 

Status byte B. The status bits have 
the following meanings: 



.1. 



• -1. 



1... 



Bit set indicates that 
the data set associated 
with this line of the 
TIOT display was present 
on the device 
represented by this TIOT 
device entry. 
Bit 1 set indicates that 
the data set associated 
with this line of the 
TIOT display would have 
used the device 
represented by this TIOT 
device entry. 
Bit 2 set indicates that 
the device represented 
by this device entry 
violated separation. 
Bit 3 set indicates that 
a volume serial number 
was present. 

Bit 4 set indicates that 
a setup message was 
required. 

Bit 5 indicates the 
device disposition that 
would have taken place 
had the dumped system 
been allowed to continue 
processing this task. 
The settings for this 
bit are: 

Indicates t \t if the 
volume was required to 
be unloaded, the volume 
was to have been 
deleted. 

Indicates that if the 
volume was requires to 
be unloaded, the 
unloaded volume was to 
have been retained. 
Bit 6 indicates that an 
unload requirement had 
been made. 

Bit 7 set indicates that 
a load or label 
verification requirement 
had been made. 



bytes 1-3 

The address of the UCB that was* used 
in all cases except when the device 
was a 2321 data cell drive. For a 
2321, this address is that of the 
description in the UCB of the cell in 
the bin. 

MFT Control Block Formatting 

The formats described below are repeated 
for each requested task that is printed. A 
sample of the major system control blocks, 
as formatted from an MFT dump, is shovm in 
Figure 23. 



0. 



MFT TASK CONTROL BLOCK (TCB) FORMATTING : 
The task control block (TCB) contains 
information pertaining to the specific task 
identified in the heading lines at the top 
of the dump listing page. It is formatted 
as follows: 



TCB hhhhhh 

The address of the task control block 
being displayed is given in this first 
display field. 

RBP hhhhhhhh 

The starting address of the request 
block (RB) that was currently 
associated with the task represented 
by this TCB. 

PIE hhhhhhhh 

The address of the first program 
interrupt element (PIE) enqueued by 
this TCB. 

DEB hhhhhhhh 

The address of the beginning of the 
data extent block (DEB) queue that was 
associated with this task. 
Information on the contents of each 
DEB in the queue is given in a 
separate portion of this MFT task's 
dump listing. 

TIO hhhhhhhh 

The starting address of the task 
input/output table (TIOT) that was 
constructed during device allocation 
for the task represented by this TCB. 
The contents of this table are 
displayed in a later portion of this 
task's display. 

CMP hhhhhhhh 

This word contains ABEND indicators 
and user and system completion codes 
as follows: 

byte 

1... ... Bit set indicates that 

a dump had been 
requested. 

.1.. .... Bit 1 is reserved for 

future use but is set 
for MVT compatibility. 

..1 Bit 2 set indicates that 

a portion of the problem 
program's main storage 
area was overlaid by a 
second load of ABEND. 
A first load overlay is 
indicated by the setting 
of bit 14 of the PK-FLG 
field. 

...x .... Bit 3 is reserved for 
future use. 

.... 1... Bit 4 set indicates that 
a double ABEND occurred 
in the dumped task. 
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MFT DUMP LISTING 



rtJJjLc IMOSADrtP DATE 11/12/70 TI« 00. SO 



PAGE 0011 



JOd JOBS 



TC<J 0091*3 



STEP GO 



PROCSTEP STEPl 



***** 



CURRENT TASK 



KbP 00009228 PIE 00000000 
HSS 30009*10 PK-FLG 1CC00008 

RG 10-1 000717B0 0C02A910 

RG 2-9 00000000 0002C304 

F3A 08071730 TCB 00009348 

LTu CCOuCGOO IQE 00000000 

STA CGvJvuOUQ TCT 000209A8 



0£B 00071634 TIG J0071728 
FLG 000001E3 LLS 000712F8 
5002A826 9BC71280 4002A896 
0007176C 0000004C 00009148 
TME 00009228 P 1 14 E0019AB8 
ECB OCCOOOOC XTC8 00000000 
USR 00000000 CAR OOGOOOOO 



CMP OCOOOOOC TRN COCCCOCO 

JLB CCOOOOOC JST 00CCS148 
5C007FD2 CCCOCOCC 000C011A 
000717F8 0CC71778 COOCOCOO 

NTC OOOOOCCC CTC OOCOCOCO 
LP/FL E300000C RES OOCOOOOO 

RES COOOOCOC JSCB 00021284 



ACTIVE RBS 

PRa 02A800 Hti GO 



SZ/STA3 OC2C0OC0 USE/EP C002A820 PSW FF150C80 9002AE7A Q COOOOOOO WT-LNK 00COS148 



IRd 009228 Nri SGKO AkY SZ/STAB 0C0E404C USE/EP G002A87E PS* FF150193 6O02A8AA 

R» 10-1 FA000048 00009228 OOOOOOOC 0002C3J4 0007176C 00CCCC4C 

KG 2-9 0007^778 COOOOOOO OO0717B0 0G02A91G 50Q2A626 0CQ2AS10 
EXTSA OJCOOOOO O00712B0 00C09228 000091*3 

p/p aouNoaiES 

HIcR 0002A3OJ TO 00071800 HIER 1 OOCOOOOO TO 00000000 



Q CCCC9268 hT-LNK CCC2A800 
0C00S148 C00717F8 
13C0COCC 4C0122EA 



lGAD LIST 



LRB 071300 
lP*B 071390 



NM OJMiYuL 
HA RETURNS 



SZ CC0C88 
SZ C000A8 



USE/EP 01071310 
USE/EP 01071360 



JGd PACK QUEUE 
MJTHING IN JQd PACK 



DEd JU63-. 



0E3 071500 



APPeNOAGiS END CF EXT 0229C0 SIO 003FF4 PCI 003FF4 CH END CC3FF4 AB END 0C3FF4 

PfX OCjCCOOO C5C0OO05 OOOIOBEO 11000000 

Ted 04009143 NOEB 1C07150C ASYN F8CC0000 SPKG OOOuJOOO UPRG C1G7144C PLST E3CC0C00 
AVT 04071610 

FM-UCd START END TRKS 

530015t>C OC020C03 00020C03 0001 

APPcNDAGcS ENC OF EXT 0138F0 SIG 013922 PCI 0136F8 CH END 013864 AB END C13922 

PFX OOOCCOuO 05COC007 000007EO OFOOOOOO 

TCd CCU09148 NOEB OCOOOOOO ASYN A8000000 SPRG dOGQQGOO UPRG 010COCCC PLST E3CCCC00 

A«/T 040136S4 

FM-UCd START END TRKS 

580015EC OOC40003 0CC500C9 0011 



prtc stepi 

TTR-STC STb-UCB 

007D0CC0 8C0015EC 

007F0300 80C015oC 



CC8 1F02A8BC 



CCB 0F071778 



TIOT 071728 


JOB JOB 5 


STEP 


GO 




OFFSET 


LN-STA 


DDNAME 




0018 


140401C0 


PGM=*.DD 




002C 


14040100 


OUMMY 



Figure 23. Sample of MFT Control Block Format 



CMP hhhhhhhh — byte — (continued) 

.... -1*. Bit 5 set indicates that 
a dump message (WTO) was 
to have been issued. 

1. Bit 6 set indicates that 

the dumped system • s 
scheduler was to have 
printed an indicative 
dump. 

1 Bit 7 set indicates that 

an ABEND message, to be 
printed by the ABDUMP 
routine, was provided. 

bytes 1-3 

The first 12 bits contain a system 
completion code. These codes and 
their meanings are explained in the 
publication IBM System/360 Operating 
System: Messages and Codes , GC28-6631 
under the heading "System Completion 
Messages." A user completion code is 
contained in the last 12 bits- 

TRN hhhhhhhh 

Contains flags as follows: 



byte 
1. 



.1.. 



..1. 



...1 



Bit set indicates that 
decimal simulator 
programs were being used 
on a System/360 model 91 
machine. 

Bit 1 set indicates that 
checkpoints were not 
taken for this step. 
Bit 2 set indicates that 
the TCB being displayed 
was associated with 
either a graphics 
foreground job or the 
graphic job processor. 
Bit 3 set indicates that 
the TCB being displayed 
was associated with a 
7094 emulator task that 
was being run on a 
System/360 model 85 
machine. 
. . xxxx Bits 4 through 7 are 

reserved for future use. 



bytes 1-3 
Reserved. 

MSS hhhhhhhh 

Main storage supervision as follows: 

byte 

This byte is reserved for future use. 

bytes 1-3 

This subfield displays one of two 
addresses. If the TCB being displayed 
represents a job step, this subfield 
contains the address of the boundary 
box. If this TCB represents a 



sub task, this field displays the 
address of the gotten queue element 
(GQE). GQEs are preset only if the 
dumped system issued a GETMAIN macro 
instruction for the space. 

PK-FLG hhhhhhhh 

The storage protection key and a 
series of flags associated with the 
task being displayed. This field is 
divided into several subfields. These 
are: 



byte 
xxxx 



0000 



byte 1 
1., 



.1.. 



..1. 



...1 



1.. 



. .1. 



..1. 



byte 2 
1. 



The storage protection 

key associated with the 

task represented by this 

TCB. 

Always contain zeros. 



Bit set indicates that 
an abnormal termination 
was in progress at the 
time the dump was taken. 
Bit 1 set indicates that 
a normal termination was 
in progress at the time 
the dump was taken. 
Bit 2 set indicates that 
ABEND was initiated by 
the resident abnormal 
termination routine. 
Bit 3 set indicates that 
recursion through ABEND 
was permitted. 
Bit 4 set indicates that 
the graphics abnormal 
termination routine had 
been entered for the 
task represented by the 
TCB being displayed. 
Bit 5 set indicates that 
the CLOSE routine was 
initiated by ABEND. 
Bit 6 set indicates that 
a portion of the problem 
program's main storage 
area was overlaid in 
order to process ABEND 
routines. (See also bit 
2 of the CMP display 
field.) 
1 Bit 7 set indicates that 
the queueing of 
asynchronous exits for 
the task represented by 
the TCB being displayed, 
was prohibited. 



Bit set indicates that 
ABEND was prohibited for 
this task. The setting 
of this bit has meaning 
only if the TCB being 
displayed represents a 
system task. 
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•xx. . -x. Bits l f 2 and 6 are 

reserved for future use. 

•..1 .... Bit 3 set indicates that 
the task represented by 
the TCB being displayed 
had a forced completion 
imposed upon it. Other 
tasks in the dumped 
system could not have 
been performed until 
this task had been 
completed. 

..... 1... Bit 4 set indicates that 
the job step had a 
forced completion 
imposed upon it. Other 
tasks in the dumped 
system could not have 
been performed until 
this job step had been 
completed. 

Bit 5 indicates that 
dump processing had been 
initiated in ABEND. 
Bit 7 set indicates that 
the task represented by 
the TCB being displayed 
was a member of a time 
sliced group. 

Bits f 1, 3 and 7 are 
reserved for future use. 
Bit 2 is an exit 
effector indicator. The 
setting of this bit 
indicates that at the 
time the dump was taken, 
system error routines 
were operating on this 
task. 

.... 1... Bit 4 set indicates that 
floating point registers 
existed in the dumped 
system. 

.... .1.. Bit 5 set indicates that 
at the time the dump was 
taken, job scheduler 
routines were 
processing. 

.... ..1. Bit 6 set indicates that 

at the time the dump was 
taken, an XCTL routine 
was changing the storage 
protection key in the 
PSW from zero to the one 
used by the problem 
program. 

FLG hhhhhhhh 

This field displays a further series 
of flags and certain priority 
indicators. This word is formatted as 
follows : 

byte 

Reserved for future use. 



*-*•>* * X* m 



...1 



byte 3 

XX. X ...X 

• >* JL • « • • * 



byte 1 

xxxx xxx. Bits through 6 are 

reserved for future use. 

.1 Bit 7 is the primary 

non-dis patchability 
indicator. Setting of 
this bit indicates that 
one or more of the 
secondary 

non-dis patchability bits 
(bytes 1-3 of the DAR 
field) was set at the 
time the dump was taken. 
If this bit is set, the 
task represented by this 
TCB was considered to be 
non-dis pat chable. 

byte 2 

This byte contains the number of 
resources for which the task 
represented by this TCB was enqueued. 

byte 3 

This byte displays the dispatching 
priority of the task represented by 
this TCB. 



LLS hhhhhhhh 

The address of the last request block 
(RB) that was created by the loading 
of a module that used the LOAD macro 
instruction. 

JLB hhhhhhhh 

The address of the data control block 
(DCB) representing the JOBLIB 
associated with this task. 

JST hhhhhhhh 

Job step information. The contents of 
this field have meaning only when the 
dumped MPT system was operating with 
the subtasking option. If this was 
the case, this field shows the address 
of the first TCB for a job step. 

RG 0-7 and RG 8-15 

The register save area of the TCB 
being displayed. This pointer is 
useful in locating the entry points of 
first routines and in tracing the save 
area chains. 



FSA hhhhhhhh 

This field displays two data elements 
and is formatted as follows: 

byte 

The TCB identification code. 

byte 1-3 

The address of the first problem 
program save area. 
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TCB hhhhhhhh 

The address of the TCB that had the 
next lowest priority on the ready 
queue at the time the dump was taken. 

TME hhhhhhhh 

The address of the timer element. 

PIB hhhhhhhh 

The PIB field displays two items of 
information in the following format: 

byte 

This byte contains flags that identify 
the partition attributes. These flags 
are: 

xx - Bits and 1 indicate 

the function of the 
partition. The possible 
functions are given 
below: 

00.. .... System task partition. 

01.. .... Reader partition. 

10.. .... Writer parti tion. 

11.. «... Processing program 
partition. 

..x. .... Bit 2 gives the 

partition size. The 
meanings of the possible 
settings are: 

..0. . ... Small partition. 

..1. .... Large partition. 

...1 .... Bit 3 set indicates that 
CPU timing was stopped 
by PINCH until a 
transient routine was 
loaded. 

.... xx.. Bits 4 and 5 are 

reserved for future use. 

.... . . 1. Bit 6 set indicate s that 

the partition associated 
with this task was a 
writer partition. This 
bit is used by ABEND, 
transient writers and 
resident writers. 

1. Bit 7 set indicates that 

at the time the system 
was dumped, the 
scheduler was in 
control. Had this 
task's TIOT been written 
to SYSl.SYSJOBQE, this 
bit would not be^ set. 

bytes 1-3 

The last portion of the PIB field 
shows the address of the partition 
information block (PIB) that was 
associated with this task's partition. 

NTC hhhhhhhh 

The address of the previous TCB that 
existed on the originating task * s 
queue of subtask TCBs (sister). If 
the TCB was the first on the queue, 
this field contains zeros. The 
contents of the NTC field have meaning 



only if the dumped system was 
operating with the MFT subtasking 
option. 

OTC hhhhhhhh 

The OTC field is applicable only when 
the dumped system was operating under 
MFT subtasking option. If this was 
the case, this field displays the 
address of the TCB representing the 
originating task (mother) . 

LTC hhhhhhhh 

The address of the last TCB that 
existed on the originating task's 
queue of subtask TCBs (daughter) at 
the time the dump was taken. If this 
TCB was the last on the queue, this 
field contains zeros. This field is 
applicable only if the dumped system 
was operating under the MFT subtasking 
option. 

IQE hhhhhhhh 

The address of the interruption queue 
element (IQE) that was used in 
scheduling the ETXR routine on the 
originating task. The contents of 
this field have no meaning unless the 
dumped system was operating under the 
MFT subtasking option. 

ECB hhhhhhhh 

If the dumped system was operating 
under the MFT subtasking option, this 
field displays the address of the 
event control block (ECB) that would 
have been posted by the supervisor's 
task termination routines had either 
normal or abnormal task termination 
been allowed to occur. 

XTCB hhhhhhhh 

The XTCB field in this TCB display is 
reserved for future use. 

LP/FL hh hhhhhh 

Priority and dump information on tasks 
that were operating under the 
subtasking option of MFT. The LP/FL 
field displays its data as follows: 

byte 

The limit priority of the task 
represented by the TCB being 
displayed. 

byte 1 

Dump information flags. 

xxxx x... Bits through 4 are 

reserved for future use. 

1.. Bit 5 set indicates that 

the task represented by 
the TCB being displayed 
was the top task in the 
tree of abnormally 
terminating tasks. 
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1. Bit 6 set indicates that 

an abnormal termination 
dump had been completed. 

1 Bit 7 set indicates that 

the task represented by 
this TCB was enqueued on 
a dump data set. 
byte 2 

This byte contains more dump 
information flag bits. The meanings 
of these bits are: 

1 Bit set indicates that 

at the time the system 
was dumped, an OPEN was 
in process for the dump 
data set. 

.xxx x . .x Bits 1 through 4 and bit 
7 are reserved for 
future use. 

.... .1.. Bit 5 set indicates that 
the dump data set was 
open for the job step. 

.... ..x. Bit 6 indicates the type 

of dump data set. The 
possible setting are: 

0. SYSUDUMP data set. 

1. SYSABEND data set. 

byte 3 

This last byte of the LP/FL field 
shows abnormal termination flags as 
follows: 

xxx. x.xx Bits f 1, 2, 4, 6 and 7 
are reserved for future 
use. 

...1 .... Bit 3 set indicates that 
a valid message 
recursion occurred in 
ABEND. 

1.. Bit 5 set indicates that 

no abnormal termination 
dumps could be provided 
within the job step 
associated with the TCB 
being displayed. 

RES hhhhhhhh 

This field is reserved for future use. 

STA hhhhhhhh 

Internal STAE routine flags and the 
address of the STAE control block that 
was in effect at the time* the dump was 
taken. 

TCT hhhhhhhh 

Information pertaining to the dumped 
system's timing control table (TCT). 
The TCT field is divided into the 
following two subf ields : 

byte 

This byte is reserved for future use. 

byte 1-3 

If the system management facilities 
option was presented in the dumped 



system, these bytes contain the 
address of the dumped system's timing 
control table (TCT). 



USR hhhhhhhh 

This word is available to the user of 
the dumped system. It contains any 
information placed in it by the user. 



DAR hhhhhhhh t 

The contents of' this field were used 
by the damage assessment routine 
(DAR). Certain subf ields displayed in 
this word were also used to control 
the dispatchability of the dumped 
task. The DAR field is divided into 
the following subf ields. 

byte 

The first byte of the DAR field 
contains DAR flags. The flags are as 
follows: 

1. Bit set indicates that 

primary DAR recursion 
occurred in the dumped 
system. The damage 
assessment routine 
failed while writing a 
main storage image dump. 

.1 Bit 1 set indicates that 

secondary DAR recursion 
occurred in the dumped 
system. The damage 
assessment routine 
failed while attempting 
to reinstate a failing 
partition. 

..1 Bit 2 set indicates that 

only the dump capability 
of the damage assessment 
routine was requested. 
...x .... Bit 3 is reserved for 

future use. 
.... 1... Bit 4 set indicates that 
the system error task is 
failing. The DAR dump 
should not request any 
error recovery procedure 
(ERP) processing. 

xx. Bits 5 and 6 are 

reserved for future use. 

1 Bit 7 set indicates that 

an SVC dump is executing 
for this task, 
byte 1 

Bytes 1 through 3 of the DAR display 
field are used to show the settings of 
secondary non-dispatchability flags 
bits. If any of the flags in this 
subfield were set, the primary 
non-dispatchability flag (the last bit 
in the FLG field) will also have been 
set and the task represented by this 
TCB will have been non-dispatchable. 
The bit settings that may appear in 
byte 1 and their meanings are: 
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xx Bits and 1 were set by 

the damage assessment 
routines. Their 
meanings are: 

1 Bit set indicates that 

the task represented by 
the TCB being displayed 
was flagged temporarily 
non- dispatchable . 

.1. Bit 1 set indicates that 

the task represented by 
this TCB was deemed 
permanently 
non-dispatchable. 

..xx .... Bits 2 and 3 are 

recovery management 
support and system error 
recovery flags. Their 
meanings are: 

..1 Bit 2 set indicates that 

the task represented by 
this TCB was flagged 
temporarily 
non-dispatchable. 

...1 .... Bit 3 set indicates that 
the task represented by 
the TCB being displayed 
was deemed permanently 
non-dispatchable. 

.... x... Bit 4 is reserved for 
future use. 

1.. Bit 5 set indicates that 

this task is temporarily 
non-dispatchable. Time 
services have been 
requested and the 
time-of-day clock is 
still inoperative. 

xx Bits 6 and 7 are 

reserved for future use. 



byte 3 
1. 



byte 2 
1.. 



.... Bit indicates that at 
the time the dumped 
system was active, 
ABDUMP was processing. 
The setting of this flag 
bit has meaning only if 
the dumped system was 
operating with the 
subtasking option of 
MPT. 

-x Bit 1 is reserved for 

future use. 

..1. .... Bit 2 set indicates that 
this task is 
non-dispatchable. An 
SVC dump is executing 
for another task. 

..x xxx. Bits 3 through 6 are 

reserved for future use. 

.1 Bit 7 set indicates that 

at the time the system 
was dumped, the dump 
data set was in the 
process of being opened. 









The setting of this 
first bit has meaning 
only if the dumped 
system was operating 
with the MFT subtasking 
option. If this bit is 
set, the indication is 
that the task 
represented by the TCB 
being displayed was 
terminated. 

Bit 1 set indicates that 
had the dumped MFT 
system, operating with 
the subtasking option, 
been allowed to continue 
processing without 
intervention by the dump 
program, the task 
represented by this TCB 
would have been 
terminated by ABEND. 
Bits 2 through 7 are 
reserved for future use. 



RES hhhhhhhh 

Reserved for future use. 

JSCB hhhhhhhh 

Contains the address of the job step 
control block. 

RES hhhhhhhh 

Reserved for future use. 

IOBRC hhhhhhhh 

Contains the address of the IOB 
restore chain for I/O quiesced by 
end -of -task. 

MFT ACTIVE REQUEST BLOCK (RB) FORMATTING : 
Request blocks (RBs) were used by the 
dumped system's supervisor to maintain 
information concerning a task. RBs 
associated with the task identified in the 
heading lines at the top of the dump page 
and in the preceding TCB display, are 
listed in the portion of the dump listing 
labeled "ACTIVE RBS". Information on each 
RB associated with the task is formatted as 
shown below: 

PRB 

LPRB 

SVRB hhhhhh 

SIRB 

IRB 

Each RB display is preceded by a field 
that indicates the type and starting 
address of the RB being displayed. 
The five types of RBs that may be 
displayed under an MFT task are: 



PRB 



LPRB 



program request block 



loaded program request block 
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SVRB 



supervisor request block (SVRBs 
may be divided into two 
categories ; type 2 for resident 
routines and type 3 or 4 for 
transient routines). 



byte 2 

STAB flag bit settings. The meaning 
of these flags are depends upon the 
type of request block being displayed. 
These flags are presented, by RB type, 
below: 



SIRB 



IRB 



PRB 



system interrupt request block 



interruption request block 



The type acronym for each RB is 
displayed in the first portion of the 
field. The starting address of the 
indicated request block appears in the 
last portion of the field. The 
contents of certain fields in the body 
of the formatted RB display are 
dependent upon the type of RB being 
displayed. Variations in display 
field usage are noted in the 
descriptions of the fields in which 
they occur. 

NM cccccccc 

The variations associated with the 
usage of this field are: 

• PRBs and LPRBs use this field to 
display the name of the program they 
represented. 

• SVRBs display the SVRB type in this 
field. 

• SIRBs use this field to present the 
eight-character name of the error 
routine that was occupying the 
supervisor transient area at the 
time the dump was taken. 

• IRBs display meaningful information 
in this field only if the timer was 
being used. If this was the case, 
the first character in this field 
represents the setting of the timer 
flags. The remainder of the NM 
field is meaningless. 



SZ/STAB hhhhhhhh 

This field displays two data elements; 
RB size information and STAB flag bit 
settings. This field is subfielded as 
follows: 

bytes 0-1 

The number of contiguous doublewords 
that were occupied by the request 
block, the associated program (if 
applicable) , and associated supervisor 
work areas. If a program extent list 
was present, the program size is not 
included in this figure. 



The following bit settings are 
applicable to program request 
block displays: 

0000 .... indicates that the 

program represented 
by this PRB was not 
loaded by a LOAD 
macro instruction; 
nor did it have minor 
entries identified by 
an IDENTIFY macro 
instruction. 

0001 .... indicate that the 

program represented 
by this PRB was not 
loaded by a LOAD 
macro instruction but 
did have minor 
entries identified by 
an IDENTIFY macro 
instruction. 

.... xx.. Bit 4 and 5 have no 
meaning in PRB 
displays. 

1. indicates that the 

program represented 
by this PRB was 
hierarchy block 
loaded and that a 
program extent list 
existed. 

1 indicates that the 

program module 
represented by this 
PRB was refreshable. 



LPRB 



Loaded program request blocks 
being displayed may have the 
following bit settings in this 
byte: 

0010 .... indicates that the 

program represented 
by this LPRB was not 
loaded by a LOAD 
macro instruction; 
nor did it have minor 
entries identified by 
an IDENTIFY macro 
instruction. 

0011 .... indicates that the 

program represented 
by this LPRB was not 
loaded by a LOAD 
macro instruction but 
did have minor 
entries identified by 
an IDENTIFY macro 
instruction. 
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SVRB 



1110 .... indicates that this 
LPRB describes a 
minor entry 
identified by an 
IDENTIFY macro 
instruction. 

.... xx.. Bits 4 and 5 have no 
meaning in LPRB 
displays. 

1. indicates that the 

program represented 
by this LPRB was 
hierarchy block 
loaded and that a 
program extent list 
existed. 

. ... ...1 indicates that the 

program module 
represented by this 
LPRB was refreshable. 



Supervisor request blocks display 
the following bit settings in 
this subfield: 

1100 .... indicates that the 

program represented 
by this SVRB is a 
type 2 SVC routine 
that had not been 
loaded at the time 
the dump was taken. 

1101 .... indicates that the 

program represented 
by this SVRB is a 
type 3 or SVC routine 
that had been loaded. 

.... 1... indicates that the 
type 3 or 4 SVC 
routine was resident. 

.... .1.. indicates that while 
the dumped system was 
active, a checkpoint 
could have been taken 
in a user exit from 
the SVC routine 
represented by this 
SVRB. 

.... ..xx bits 6 and 7 have no 

meaning in SVRB 
displays. 



IRB 



SIRB 



The flag bit setting applicable 
to supervisor interrupt request 
block displays is as follows: 



1000 



xxxx 



indicates that the RB 
being displayed is a 
supervisor interrupt 
request block (SIRB). 
bits 4 through 7 have 
no meaning in SIRB 
displays. 



Interrupt request block displays 
use these flag bits in the 
following manner. 

0100 .... indicates that the RB 
being displayed is an 
interrupt request 
block (IRB). 

.... xxxx bits 4 through 7 have 
no meaning in IRB 
displays. 



byte 3 

The last byte of the SZ/STAB field 
displays more, status and attribute 
flags. The possible settings for this 
subfield and their meanings are: 

1 Bit set indicates that 

the WT-LNK field in this 
RB display contains, in 
its last three bytes, 
the address of the TCB 
to which this request 
block is linked. 

.1,. .... Bit 1 set indicates that 
at the time the dumped 
system was active, the 
program associated with 
the RB being displayed 
was active. 

..1 Bit 2 set indicates that 

had the dumped system 
been allowed to continue 
processing without 
intervention by the dump 
program, general 
registers 2 through 14 
would have been restored 
from this RB's general 
register save area, 
displayed on the 
following two lines. 
The setting of this bit 
is valid only for IRB, 
SIRB and SVRB displays. 

...1 .... Bit 3 set indicates that 
the program module 
represented by this 
request block was 
reenterable or reusable. 

.... xx.. Bits 4 and 5 are used 
only in IRB or LPRB 
displays. The settings 
of these bits and their 
meanings are: 

.... 00.. This setting indicates 
that the IRB being 
displayed had no 
interrupt queue elements 
(IQEs) associated with 
it. 
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01- . This setting indicates 
that the IRB being 
displayed had associated 
with it interrupt queue 
elements that were 
request queue elements 
(RQEs). 

10. . This setting indicates 
that the request block 
being displayed is a 
dummy LPRB, in a 
partition that 
represents a program in 
the reenterable load 
module area. The LPRB 
for the program is in 
the reenterable load 
module area. 

11. . This setting indicates 
that the IRB being 
displayed had interrupt 
queue elements 
associated with it that 
were not request queue 
elements (RQEs). 

. .1. Bit 6 set indicates that 
when the dumped system 
was active, request 
block storage was to 
have been freed when the 
program returned. 

...x Bit 3 indicates wait 

request conditions. The 
meanings of the two 
possible settings for 
this bit are: 

...0 Bit 7 not set indicates 
that the request had to 
wait for a single event 
or for all of a number 
of events. 

...1 Bit 7 set indicates that 
the request had to wait 
for a number of events. 
This number of events 
was less than the total 
number of events that 
were waiting. 



USE/EP hhhhhhhh 

The USE/EP field, as indicated by the 
field identifier, displays two data 
elements. These are shown in the 
following format: 



byte 1-3 

The second portion of the USE/EP field 
displays the address of the entry 
point of the module represented by 
this request block. 

PSW hhhhhhhh hhhhhhhh 

The two words of the PSW field display 
to the user the dumped system's old 
program status word. If the dumped 
system had been allowed to continue 
processing without interruption by the 
dump program, operation would have 
resumed on this PSW. 

Q hhhhhhhh 

The information displayed in this 
field depends upon type of RB being 
displayed. The contents of this 
display field are described below, by 
RB type: 

• PRBs and LPRBs use this field to 
display the address of an LPRB 
describing an entry that was 
identified via the IDENTIFY macro 
instruction. 

• SVRBs representing type 3 or 1 SVCs 
use this field to indicate the size 
of the program they represent in 
bytes . 

• SIRBs and IRBs display in this field 
the address of a 12- or 16-byte 
request element. 

WT-LNK hhhhhhhh 

This field displays information 
pertaining to wait counts and request 
block linkages. The field is divided 
into the following two subfields: 

byte 

The number of requests that were 
pending at the time the dump was taken 
(wait count). 

byte 1-3 

The address of the next request block 
on the RB queue. If the RB being 
displayed was the last request block 
on the queue, this field shows the 
address of the task control block 
(TCB) that enqueued this RB. 



byte 

The first byte of this field contains 
the use count that was applied to the 
program module represented by the 
request block being displayed. This 
use count was calculated by 
subtracting the number of invocations 
of the DELETE macro instruction from 
the number of times the LOAD macro 
instruction was used. 



RG 0-7 and RG 8-15 

The sixteen-word register save area 
appears only after IRB, SIRB or SVRB 
displays. These two lines display the 
contents of general registers 
through 15 as they were stored in the 
request block. 

MFT PROBLEM PROGRAM BOUNDARIES INFORMATION : 
Each task operating under the MFT option of 
the operating system was assigned a main 
storage partition in which to operate. If 
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the system configuration included 2361 
Large Core Storage, partitions may have 
included area from both hierarchy (main 
storage) and hierarchy 1 (low speed main 
storage). If 2361 Large Core storage was 
not available or was not used, hierarchy 1 
pointers were set to zero. Each MFT task 
displays in its dump listing the limits of 
the partition in which it operated. This 
display is presented under the heading "P/P 
BOUNDARIES" Cproblem program boundaries) in 
the following format: 

HIER hhhhhhhh 

The starting address of the problem 
program's hierarchy partition. 

TO hhhhhhhh 

The ending address of the problem 
program's hierarchy main storage 
partition. 

HIER 1 hhhhhhhh 

The starting address of the problem 
program's hierarchy 1 partition. If 
this field contains zeros, the 
indication is that 2361 Large Core 
Storage was either not available or 
not utilized by this task. 



USE/EP hhhhhhhh 

Use count and entry point address as 
follows: 

byte 

The use count that was applied to the 
program module represented by the 
request block being displayed. This 
use count was calculated by 
subtracting the number of times the 
DELETE macro instruction was issued 
from the number of times the LOAD 
macro instruction was used. 

byte 1-3 

The address of the entry point of the 
program module named in the NM field 
of this RB display line. 

MFT JOB PACK QUEUE FORMATTING : A job pack 
area queue was maintained by the dumped 
system's supervisor for each job step that 
used a program not in the resident 
reenterable load module area. A job pack 
queue created by an MFT supervisor consists 
of loaded request blocks (LRBs), loaded 
program request blocks (LPRBs) and FINCH 
request blocks (FRBs). A formatted job 
pack area queue display appears as follows : 



TO hhhhhhhh 

This last field indicates the high 
limit of the problem program's 
hierarchy 1 partition if one was used. 
If this field contains zeros, either 
2361 Large Core Storage was not 
available or it was not used by this 
task. 

MFT LOAD LIST FORMATTING : A load list was 
maintained by the dumped system's 
supervisor in order to keep track of the 
load modules that were in main storage and 
the area of main storage each occupied. A 
load list created by an MFT supervisor is 
composed of loaded request blocks (LRBs) 
and loaded program request blocks (LPRBs). 
A formatted listing of the dumped MFT 
system's load list appears as follows: 

LRB 

LPRB hhhhhhhh 

The type of request block being 
displayed and its starting address. 

NM cccccccc 

The eight -character name of the 
program module represented by the 
request block being displayed. 

SZ hhhhhh 

The number of contiguous double words 
that were occupied by the request 
block, the associated program (if 
applicable) and associated supervisor 
work areas. If a program extent list 
was present, the program size is not 
included. 



LRB 

LPRB hhhhhh 

FRB 

The type of request block being 
displayed and its starting address. 

NM cccccccc 

The eight-character name of the module 
represented by the request block being 
displayed. 

SZ hhhhhh 

The number of contiguous doublewords 
that were occupied by the request 
block, the associated program (if 
applicable) and associated supervisor 
work areas. If a program extent list 
was present, the program size is not 
included. 

USE/EP hhhhhhhh 

XRWTL 

The usage of this display field is 
dependent upon the type of request 
block being displayed: 

USE/EP 

is used for LRBs and LPRBs and 
displays the use count and entry 
point address as follows : 

byte 

The use count that was applied to 
the program module represented by 
the request block being 
displayed. This use count was 
calculated by subtracting the 
number of times the DELETE macro 
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instruction was issued from the 
number of times the LOAD macro 
instruction was used. 



bytes 1-3 

The address of the entry point of 
the program module named in the 
NM field of this display line. 

XRWTL 

is used for FRBs and shows the 
starting address of the wait list 
element. 

XRREQ hhhhhhhh 

This field appears only in FRB 
displays, and shows the address of the 
TCB representing the task on whose 
behalf this FRB was constructed. 

XRTLPRB hhhhhhhh 

This field appears only in FRB 
displays and shows the starting 
address of the area of main storage 
that was acquired by the FETCH routine 
for the module identified by the NM 
field of this line. 



MFT DATA EXTENT BLOCK (DEB) FORMATTING : 
Data extent blocks (DEBs), describing a 
data set's external storage requirements, 
were queued to those task control blocks 
(TCBs) that represented tasks requiring 
auxiliary storage input/output processing. 
External storage information, taken from 
each DEB, is formatted as shown below: 

DEB hhhhhh 

The starting address of the basic 
section of the DEB being displayed. 

APPENDAGES 

The word "appendages" informs the user 
that the five named fields on this 
line contain information taken from 
the appendage vector table preceding 
the DEB being displayed. The named 
fields appearing on the rest of this 
line are: 



AB END hhhhhh 

The entry point of the abnormal- end 
appendage routine. 

PFX hhhhhhhh hhhhhhhh hhhhhhhh 

The second line of a DEB display 
contains information taken from the 
prefix section of the DEB being 
displayed. The area is subdivided as 
follows: 

byte 

The first byte of the prefix area 
contains the contents of the I/O 
support work area. This area is used 
only by DEBs dealing with direct 
access storage devices. 

bytes 1-7 

The next seven bytes of the DEB prefix 
section are used by DEBs associated 
with direct access storage device 
functions. This subfield displays the 
data set control block's (DSCB) 
address used by I/O support. The 
address is expressed in the following 
format: 



bytes 1 and 2 
bytes 3 and 4 
bytes 5 and 6 
byte 7 



the bin (cell) number, 
the cylinder address, 
the track address, 
the record number. 



bytes 8-11 

The third word of the PFX field 
contains the data control block (DCB) 
modification mask that was used by I/O 
support. 

byte 12 

The length of the DEB in double words. 

bytes 13-15 

The remainder of the DEB prefix 
section is reserved for future use. 

TCB hhhhhhhh 

This field marks the beginning of the 
basic section of the data extent 
block. The TCB field is divided into 
two subfields as follows: 



END OF EXT hhhhhh 

The entry point of the end-of-extent 
appendage routine. 

SIO hhhhhh 

The entry point of the start I/O 
appendage routine. 

PCI hhhhhh 

The entry point of the 
program-controlled-interruption 
appendage routine. 

CH END hhhhhh 

The entry point of the channel- end 
appendage routine. 



byte 

The number of subroutines for which a 
LOAD macro instruction was issued 
during the execution of the OPEN 
executor routines. 

bytes 1-3 

The starting address of the task 
control block to which this DEB was 
enqueued . 

NDEB hhhhhhhh 

byte 

The overall length of a data extent 
block includes the length of a 
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variable length access method 
dependent section. The first byte of 
the NDEB field expresses the length of 
the access method dependent section in 
bytes- If the access method was BDAM, 
this indicator is expressed as a 
number of full words. 

bytes 1-3 

The last portion of the NDEB field 
displays the starting address of the 
basic section of the next DEB on the 
task's queue. If this DEB was the 
last on the queue, the content of this 
field is the starting address of the 
TCB that enqueued this DEB. 

ASYN hhhhhhhh 

This field contains data set status 
flags and the address of the 
associated IRB: 

byte 

The first byte of the ASYN field 
contains data set status flags. These 
flags have the following meanings: 

xx. . .... Bits and 1 indicate 

the data set's 
disposition. The 
possible settings are: 

01 This setting indicates 

that the disposition was 
OLD. 

10 This setting indicates 

that the disposition of 
the data set was MOD 
(modify). 

11 This setting indicates 

that the disposition was 
NEW. 

. .1. .... Bit 2 set indicates that 
an end- of- volume (EOV) 
or end-of-file (EOF) 
condition had been 
encountered. 

...1 .... The setting of bit 3 has 
one of two meanings 
depending upon the 
external storage medium. 
For disk, this indicator 
reflects a release of 
unused external storage. 
For tape, this indicator 
means that an emulator 
tape with second 
generation format was 
being used. 

.... 1. . . Bit 4 set is a data 
control block (DCB) 
modification indicator. 

1. . Bit 5 set has two 

meanings, depending upon 
the auxiliary storage 
recording medium. For 
disk, the setting of bit 
5 indicates that a split 
cylinder was 



..1. 



encountered. For tape, 
this flag indicates that 
an emulator tape with 
possible mixed parity 
records was used. 
Bit 6 set indicates the 
use of nonstandard 
labels. 

Bit 7 set indicates that 
reduced error recovery 
procedures were used on 
magnetic tapes 
containing the data set 
represented by this DEB. 



bytes 1-3 

The last portion of the ASYN field 
shows the starting address of the IRB 
that was associated with asynchronous 
appendage exit scheduling. 

SPRG hhhhhhhh 

This field contains information on I/O 
processing methods and the system 
PURGE routine. 

byte 

The first byte of this field contains 
flags that indicate the method of 
input/output processing and the 
disposition of the data set that was 
to have been performed when an end-of- 
volume condition occurred. These flag 
settings are: 



1.. 



0.. 
.xx 



..01 
..11 



xxxx 



0000 
1111 
0011 
0111 
0001 
0100 



Bit was set by ABEND. 

The setting of this bit 

indicates that the data 

set associated with this 

DEB was a SYSABEND or 

SYSUDUMP data set. 

Bit 1 is always zero. 

Bit 2 and 3 show the 

end-of-volume 

disposition procedure. 

The values for this flag 

are: 

REREAD 

LEAVE 

The last half of this 

byte contains flags that 

indicate the type of 

input/ out put processing 

that was performed on 

the data set represented 

by this DEB. The values 

for this flag are: 

INPUT 

OUTPUT 

INOUT 

OUT IN 

RDBACK 

UP DAT 



byte 1 

The quiesce count. The byte is 
associated with the system PURGE 
routines (SVC 16) , and indicates the 
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number of auxiliary storage devices 
that were executing the user's channel 
programs . 

bytes 2-3 

Reserved for future use. 

UPRG hhhhhhhh 

The UPRG field contains extent 
information and data used by the 
user's purge routines. This field is 
divided into the following two 
subfields: 

byte 

The number of extents that were 
specified in the DSCBs associated with 
this DEB. 

bytes 1-3 

The address of the first input/output 
block (IOB) in the user's purge chain. 

PLST hhhhhhhh 

Task priority and supervisor purge 
information are contained in this 
field. This field is formatted as 
follows : 

byte 

The priority of the task under which 
this DEB was enqueued. 

bytes 1-3 

The starting address of a parameter 
list that was used to locate the purge 
event control block (ECB) for a 
supervisor purge request. 

DCB hhhhhhhh 

The DCB field contains three data 
elements. These are displayed in the 
format given below: 



byte 
xxxx 



.... The storage protection 
key that was associated 
with the task under 
which this DEB was 
enqueued. 

1111 A hexadecimal "F" in 

bits 4 through 7 of this 
field identify this 
control block as a data 
extent block (DEB) . 



bytes 1-3 

The starting address of the data 
control block (DCB) that was 
associated with this DEB. 

AVT hhhhhhhh 

The AVT field displays two DEB data 
elements and is subfielded as follows: 

byte 

The DEB extent scale that is used to 
determine the size of the device 



dependent section of this DEB. For 
direct access devices, a 4 is 
displayed in this subfield. For a 
nondirect access device or a 
communication device, a 2 is 
displayed. 



bytes 1-3 

In most cases, the last portion of the 
AVT field shows the starting address 
of the appendage vector table 
preceding this DEB. This table of 
appendage routine addresses appears on 
the first line of this DEB's display. 



OP-UCB hhhhhhhh 

The contents of this field have 
meaning only when the DEB being 
displayed describes a data set that 
was assigned to a unit record or 
magnetic tape device. This 
information is formatted from the 
device dependent section of the DEB. 
The OP-UCB field is subfielded as 
follows: 



byte 

This first subfield is applicable only 
to data sets assigned to magnetic tape 
devices, and shows the SET MODE 
operation code. For a data set that 
was assigned to a unit record device, 
this subfield is reserved. 



bytes 1-3 

The starting address of the unit 
control block (UCB) associated with 
the data set described by the DEB 
being displayed. 

The following four fields are present only 
for data sets assigned to the IBM 3525 Card 
Punch for multi -function. The information 
is formatted as shown below: 

UCB hhhhhhhh 
byte 

The device modifier field (not used 
for the 3525). 
bytes 1-3 

The starting address of the unit 
control block (UCB) associated with 
the data set described by the DEB 
being displayed. 

RDRDCB hhhhhhhh 

The starting address of the data 
control block (DCB) for the read 
associated data set. 

PCHDCB hhhhhhhh 

The starting address of the data 
control block (DCB) for the punch 
associated data set. 
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WTRDCB hhhhhhhh 

The starting address of the data 
control block (DCB) for the print 
associated data set. 

The final portion of a DEB display shows 
information pertaining to a data set that 
was assigned to a direct access device. 
This information, taken from the DEB*s 
device dependent section, is arranged in 
columnar format with a line for each 
extent. The information is formatted as 
shown below: 

FM-UCB hhhhhhhh 

The first column displays two data 
elements and is formatted as follows: 

byte 

The device modifier showing the file 
mask. 

bytes 1-3 

The starting address of the unit 
control block (UCB) that was 
associated with the data extent. 

START hhhhhhhh 

The address of the beginning of the 
direct access device extent. The 
first four characters represent the 
cylinder address and the last four 
characters represent the track 
address. 

END hhhhhhhh 

The address of the end of the data 
extent. Cylinder and track references 
are formatted as in the extent 
beginning address, described above. 

TRKS hhhh 

The number of direct access tracks 
bounded by the starting and ending 
addresses shown in the previous two 
columns. 



MET TASK INPUT/OUTPUT TABLE (TIOT) 
FORMATTING : A task input/output table 
(TIOT) was constructed for each task in the 
dumped system by MFT job management 
routines. This table contained primary 
pointers to control blocks used by I/O 
support routines. As the functions* of 
several TIOT fields were dependent upon the 
state of associated external storage 
devices, multiple definitions may apply. 
The TIOT that was constructed in the dumped 
MFT system is formatted as shown. 

TIOT hhhhhh 

The starting address of the task 
input/output table being displayed. 

JOB cccccccc 

The eight-character name of the job 
for which this TIOT was constructed. 



STEP cccccccc 

The eight-character name specified in 
the label field of the EXEC JCL 
statement associated with this job 
step. 

PROC cccccccc 

If the job step for which this TIOT 
was constructed was invoked from a 
cataloged procedure, the procedure 
name, as contained in the EXEC JCL 
statement, is displayed in this field. 

Each data set associated with the indicated 
task is represented by a separate DD entry 
that is included in the TIOT. Each TIOT 
entry is displayed on a separate line in 
columnar format. The use and meaning of 
each column is given below: 

OFFSET hhhh 

The offset of this DD entry from the 
beginning of the TIOT in hexadecimal* 

LN-STA hhhhhhhh 

byte 

The total length (including all device 
entries) in bytes of the DD entry 
being displayed on this line. 

byte 1 

Status byte A, one of three status 
bytes in a TIOT entry. The meanings 
of the status byte settings are: 



x. . 



0... .0. 



0... .1, 
1... .0, 

.1.. ... 



Bits and 5 indicate 
the tape label 
processing that was to 
have been performed. 
The meanings of the 
settings are: 
Nonlabeled tape or an 
indication to bypass 
label processing. 
Standard labels or 
standard user labels. 
Nonstandard labels. 
The setting of status 
bit 1 has two meanings, 
depending upon the 
processing phase that 
had been reached at the 
time the system was 
dumped. During 
allocation processing, 
the setting of this bit 
indicates that this 
entry represents a split 
cylinder primary space 
allocation DD. If the 
dump was taken during 
step termination 
processing, the setting 
of this bit indicates 
that no unallocation of 
space was necessary. 
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-.1. .,.., The setting of status 
bit 2 works under the 
same philosophy as 
status bit 1. During 
allocation processing, 
the setting of this bit 
indicates that this 
entry represents a split 
cylinder secondary space 
allocation DD. If the 
dump was taken during 
step termination 
processing, the 
indication was one of 
rewinding with no 
unload. 
...1 . ... Bit 3 set indicates that 

this DD entry represents 
a JOBLIB. 
.... 1... Bit 4 set indicates that 

direct access device 
space management was 
deemed necessary. 
.... ..1. The setting of bit 6 

specifies that the tape 
volume was to have been 
rewound and unloaded. 
.... ...1 The setting of bit 7 

specifies that the tape 
volume was to have been 
rewound, 
byte 2 

The third byte of this column has 
meaning only during the allocation 
phase. This displays the number of 
devices that were requested by the 
data set represented by the TIOT entry 
displayed on this line. 

byte 3 

The last byte of the LN-STA field 
displays a TIOT field that had meaning 
at two points during the processing of 
this task. During the allocation 
process, this field contained a link 
to the appropriate prime split, unit 
affinity, volume affinity or 
suballocate TIOT entry. After CLOSE 
processing, this byte was used as 
follows : 

1... .... The setting of bit 

indicates that the data 
set represented by this 
DD entry was a SYSOUT 
data set tha\ contained 
data. 
.xxx xxxx Bits 1 through 7 are 

reserved for future use. 

DDNAME cccccccc 

The eight character DD name associated 
with the TIOT entry being displayed. 

TTR-STC hhhhhhhh 

The first three bytes of this column 
display the relative track address 
(TTR) of the job file control block 
(JFCB) associated with this entry. 



STB-UCB hhhhhhhh 

The last column in a TIOT display 
contains information tdken from the 
one -word device entries that are 
appended to each TIOT entry. One TIOT 
device entry exists for each allocated 
device. This display field shows this 
information in the following format: 

byte 

Status byte B. The status bits have 
the following meanings: 

1. Bit set indicates that 

the data set associated 
with this line of the 
TIOT display was present 
on the device 
represented by this TIOT 
device entry. 

.1... .... Bit 1 set indicates that 

the data set associated 
with this line of the 
TIOT display would have 
used the device 
represented by this TIOT 
device entry. 

..1 Bit 2 set indicates that 

the device represented 
by this device entry 
violated separation. 

...1 .... Bit 3 set indicates that 
a volume serial number 
was present. 

.... 1... Bit 4 set indicates that 
a setup message was 
required. 

x. . Bit 5 indicates the 

device disposition that 
would have taken place 
had the dumped system 
been allowed to continue 
processing this task. 
The settings for this 
bit are: 

.... .0.. Indicates that if the 
volume was required to 
be unloaded, the volume 
was to have been 
deleted. 

1.. Indicates that if the 

volume was required to 
be unloaded, the 
unloaded volume was to 
have been retained. 

.1. Bit 6 indicates that an 

unload requirement had 
been made. 

.... ...1 Bit 7 set indicates that 

a load or label 
verification requirement 
had been made, 
bytes 1-3 

The address of the UCB that was used 
in all cases except when the device 
was a 2321 data cell drive. For a 
2321, this address is that of the 
description in the UCB of the cell in 
the bin. 
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TSO System Block Formatting 

The TSO control blocks are divided into two 
groups: system and user. The control 
blocks are discussed in the order in which 
they appear when both groups are requested. 
Some control blocks are formatted and 
printed when either group is requested. 



An example of a TSO system and user dump 
listing is shown in Figure 24. 



TIME SHARING COMMUNICATIONS VECTOR TABLE 
(TSCVT) FORMATTING : The time sharing 
communications vector table is a secondary 
CVT to meet the time sharing requirements. 
The time sharing CVT resides in the time 
sharing region; therefore, it exists only 
while the time sharing region is active. 
When time sharing does not exist in the 
system, the MVT CVT pointer to the TSCVT is 
zero. 



TSCVT hhhhhh 

The address of this time sharing 
communications vector table. 

TJB hhhhhhhh 

The address of the time-sharing job 
block (TJB) table. This table 
contains all of the TJBs allowed TSO 
users. The first TJB is for the 
terminal job identification (TJID) 
equal to zero. 

RCB hhhhhhhh 

The address of the region control 
block (RCB) table. It is an indexed 
table containing one RCB for each 
possible time sharing region; 
therefore, the table contains the 
maximum number of RCBs that may be 
used by time sharing. The first RCB 
is for region one. 

RPT hhhhhhhh 

The address of the reference point 
table (RPT). It is used by the 
terminal input output coordinator 
(TIOC). 

FLG hhhh 

These flags indicate functions 
requested from the time sharing 
control task (TSC). 



.1. TSCSWPBG: Bit 1 set 

indicates that a swap should 
be started. 

..1 TSCLOGON: Bit 2 set 

indicates that a logon is 
required. 

...1 .... TSCDISC: Bit 3 set 

indicates that a disconnect 
is required. 

.... xxxx Bits 4 through 7 are 

reserved for future use. 

byte 1 

Reserved for future use. 

FL1 hhhh 

These flags indicate atypical 
functions required by the time sharing 
control task (TSC) . 



byte 
1... .. 



.1.. .. 



.1. . 



byte 
1... 



TSCSWPND: Bit set 
indicates that a swap has 
ended . 



TSCSSTOP: Bit indicates 
that a system stop has been 
requested and the time 
sharing system is in the 
process of stopping. 

TSCRSTOP: Bit 1 indicates 
that a region stop has been 
requested. 

TSCASTOP: Bit 2 is the 
ABEND-STOP flag. When set, 
it indicates to the time 
sharing control task (TSC) 
that time sharing should be 
stopped. This flag is set 
by (1) the TSO/RMS interface 
return when a machine check 
occurs in TCAM or (2) the 
TCAM STAE exit when TCAM 
abnormally terminates. 



...x xxxx Bits 3 through 7 are 

reserved for future use. 

byte 1 

Reserved for future use. 

SDC hhhhhhhh 

The address of the first data control 
block (DCB) for swap data sets. 

CUS hhhh 

A count of the current TSO users 
logged onto the system. For 
additional users to be logged onto the 
system, this number must be less than 
the value in LUS. 
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§ 

s 

o 

c 
ft 

o 

H 



o 



TSCVT 0DDA9C 



TJB 0COLDCE8 
CUS 0C04 
SAV 0C00DB20 
102 0OO03B50 
SLF 0G0CDF10 
SVQ CCCC0OO0 
OMP 0C0DD998 



RCB 000DOFB8 
LUS 000A 
ECB 000DDB14 
103 000D3E46 
TSC 0001ACD0 
ABN 00001C20 
TC6 0001A508 



RCB 0DDFB8 



RCT 

NMBR 

UTTMQ 

PRG 

CONID 



0001A7B8 

01 

0000 

OEOOOOOO 
00 



ECB 

PKEY 
CUSE 



C0000001 

EO 

0004 



PRG1 000A79D0 
RESV 000000 



RPT 00009DD0 
NTJ OOOA 
SIA OOODDCDC 
002 000D28C8 
SPL 0001B4E8 
D03 000DE880 



OIECB 00000000 
UMSMN 04 
EXTNT 0O0A7F63 
PRG2 000A7F1C 



MODULE IMOSADMP 


DATE 11/12/70 


TIME 


00.12 


FLG 0000 


FL1 0000 


SDC 


00000000 


SZU 0030 


CTR 0001 


MUS 


OOOA 


ICB 000DDC34 


101 000D38C4 


TQF 


00014674 


LCQ 00000000 


TRB 00000000 


L»»A 


00000000 


RSZ 0028 


RSV 0000 


SVT 


00000000 



PAGE OOOf 



FLM 00OOPQ40 



QTP 000DFD40 



T08 0000EAD8 



TJID 0004 
FLG 40 
UMSM 000DDFA8 
OPL 000A7F10 



RS1ZE 004B 
PLG2 20 
SDCB 0000E120 
STECB 00000000 



LSOSZ 0005 
FBOE 01 
PQE 0001AC20 
RCOVR OBOOFFOO 



JMSM 00DFA8 ADDR-LN CA*58CC60 



ADOR-LN 0CB8OO20 



ADDR-LN 00000000 



ADDR-LN OOOOOOCO 



SWAP DCB OOCOOO 



CA58GO 




STORAGE 


0A5800 





00000000 


0A5820 





00000000 


0A584C 





ocoooooo 


JA5860 





cooooooo 


0A5880 





TO NEXT L 


0A6C20 





0012CC02 


DA6C40 





000CCFA3 


JA6C60 





0OOA7788 


3A6C8C 





00000000 


0A6CA0 





OOOCOOOO 


0A6CC0 





0004CCOO 


0A6CE0 





COOOOOL-0 



KEY 
000A58C8 00CA7260 00000000 
OOCAFOOO OCOOOOOC 00000000 
CO0C1468 CCCCOOOC OCOOOOOO 
COOCOOOO CCCCOOOO 00000000 
INE ACORESS SAME AS ABOVE 
CCCCOOOO FFC40000 00O0CAF8 
0000C28C COOA6068 000A7700 
00C1C1CO 000D9DF4 OCOOOOOO 
OOCCOOOO CCCOOOOC OCOOOOOO 
OOOOOCOO 000A7478 C0000098 
CCCCCCCO CCCCOOOO 00000000 
COCCCCCC CCCCOOOO OOCDOOOC 



0OOA58C0 O0J0283O C0CA5820 000A5620 * 

0001A7B8 00028000 OO0A580O 00000000 * 

OOOOOOCO OCOOOOOO 00000000 OCOOOOOO * 

00000000 00000000 OCOOOOOO 00000000 * 

OOOCOOOO 000A7700 COOOOOOO 00000000 * 8 

4000A4B6 00000001 OOOD0018 00009DD0 * B 

A000A5F3 9000A60C 00000000 00000000 * A. ...4 8. 

OOOCOOOO 00000000 00000000 OOOOOOCO * 

000CD710 00000000 00124034 0OOOB834 * P.. 

OOOCOCOO 00000000 CCCOOOOO OOCOOOOO * 

OOOOOOCO OOOOOODC CCOOOOOO OOCOOOOO * 



Figure 24. Sample of TSO Control Block Format (Part 1 of 3) 
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MODULE IMOSAOMP DATE 11/12/70 TIME 00.12 
***** TSO USER CONTROL BLOCKS ***** 



PAGE 0007 



****************** 



USER KGN01 



TJID=0001 



******************** 



TJB 000018 



UMSM 00DF08 



TSB 0D9DF4 



TSB 000D90F4 
RCB 000DCFB8 
USER KGN01 
RSV OCOOOO 



ATTN 00 
UMSM 000D0F08 
IPPB 00000000 



STAX 01 
SDCB 0O0DE120 
NEWID 00 



STAT 00 
UTTMQ 0002 
FLUSL 00 



STAT2 00 EXTNT 000A7F68 
RSTOR 48 UMSMN 04 
TJID 0001 MONI 00 



AODR-LN 0A5 80C38 



ADDR-LN 0A980058 



AOOR-LN 0CB00028 



ADDR-LN 00000000 



STAT 81 
NOBF 00 
CLEAR 00 
ATNTC 0000 
AUTOI 00000000 



TJB 00CD18 
CBFP 000000 
QCB 0E1CC0 
LNNO 00 



FLG1 00 

BPKFL 00 

ECB 00000000 

BLNK 00 

ERSOS 00000000 



WTSB 


000000 


LNSZ 


78 


OTBFP 


000000 


ITBFP 


000000 


NITR 


01 


IBFP 


ODAOFO 


TJID 


0001 


STCC 


0000 


ATNLC 


0016 


ASRCE 


0000 


ATNCC 


0003 


AUTOS 


00000000 



**** THE FOLLOWING TJBX,*AXE,PSCB , TCB' S AND STORAGE ARE FROM THE SWAPPED DATA SET ***** 



TJBX 0A7F68 



JOB KGN01 



TCB 0A70A0 



XFST C00A7DAC 
TAXE 000A6CB0 
XNQPE OOOA 
XKEYA C0CA7FB0 

STEP KGN01 



XLAST 0OOA6D68 
XLECB 00000000 
XNTCB 0002 



PROCSTEP STARTING 



XDSE 0OOA7320 

XPSWD 

XLQPL 0054 



XSVRB O00A770O 
RSV 00000000 
HBFL 0000 



XRQE 00000000 
XAIQE 00000000 
XACT 00000000 



XIOE 00000000 
XQPL OOOATFio 
XAECB 0001A534 



RBP 0O0A7D18 FIE COOOOOOO 
MSS 030A79A0 PK-FLG EOOOOOOO 

RG 0-7 00000001 FFF58C74 

RG 8-15 O00A737O FFFFFFF9 

FSA 0300C0C0 TCB 000A6D68 

LTC 000A6D68 IOE 00000000 

STA 200CC498 TCT 00CA73D8 



DEB 00000000 TIO 000A7864 

FLG 0001B8B8 LLS 0C0A7EA0 
0001A534 0001A500 0O0A751O 
O00A7564 000A6D68 600PEAB2 

TME 00000000 JST 000A7DA0 

ECB OOODDFBC TSPR 8000B828 

USR 00000000 DAR 00001000 



CMP 00000000 TRN 00000000 

JLB OOOOCOOO JPQ 000A7EB0 
000A7DA0 00000000 OOOOOuOi 
O00A7534 400FES30 600062FA 

NTC 00000000 OTC 0001A7B8 
D-PQE 0O0A581O SOS 00OA6O40 

RES 00000000 JSCB OO0A7E0O 



ACTIVE RBS 



D RB 0A7018 



RESV 
Q/TTR 



COOOOOOO 
OCOCOOOO 



APSW 00000000 
WT-LNK 010A7DA0 



WC-SZ-STAB 00040083 FL-CDE 0001D5B0 PSW FF050001 500FEC8A 
NM IEFSD263 EPA OFEABO STA OFEABO LN 000550 ATRl B9 



MAIN STORAGE 
D-PQE 000A5810 



FIRST 000A5820 LAST 0C0A5820 



PQE 0A5820 



FFB CCCCCOOO 
TCB C0C1A7B8 



LFB OOOAFOOO 
RSI C0026000 



NPQ OOOCOOCO 
RAD 000A5800 



PPQ 00300000 
FLG 0000 



Figure 24. Sample of TSO Control Block Format (Part 2 of 3) 
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MODULE IMDSAOMP DATE 11/12/70 TIME 00.12 PAGE 0010 


DEB 


0A74A4 


APPENDAGES END 


OF EXT 01516E SIO 01516C PCI 


0151DC CH END 0151A0 AB END 01516C 






PFX 00000000 C2C00C0B 00003FE2 110000C0 








TCB 050A6D68 NDEB 


01000000 


ASYN 69000000 SPRG 


00000000 UPRG 02000000 PLST B8000000 OCB EF0CCE64 






AVT 04015158 














FM-UCB START 


END 


TRKS 










50002AFO 0C61C000 


0C920013 


03E8 










50002AB0 0O9F0OOO 


00C60013 


0320 






TIOT 


0A6E28 


JOB KGN01 STEP 


TMP 


PROC KGNPOl 








OFFSET 


LN-STA 


DDNAME 


TTR-STC 


STB-UCB 








0018 


14CA01C0 


S\ SPRINT 


00491600 


80002570 








002C 


14040140 


SYSCCHD 


O0480AO0 


80002AF0 








0040 


140401C0 




C0481000 


80002AB0 








0054 


14040100 


SYSUCUMP 


00491800 


80002530 








0068 


14040100 


SYSUT1 


00481200 


80002530 








007C 


14040100 


SYSUT2 


004B0600 


80002570 








0090 


14040100 


BSLOUT 


00491A00 


800025F0 








00A4 


14040100 


SNAPTAPE 


004C1100 


80002530 








C0B8 


14000010 


DD1 


C04B0800 


00000000 








OOCC 


14000010 


DD2 


004B0C00 


00000000 








OOEO 


14000010 


DD3 


004B0E00 


00000000 








00F4 


140C0010 


DD4 


0C4E0100 


00000000 








0108 


140C0010 


DD5 


00AE0300 


00000000 








one 


140C0010 


0D6 


004E0500 


00000000 








0130 


140C0010 


DD7 


004E0900 


00000000 








0144 


140C0010 


DD8 


004E0B00 


00000000 




PSCB 


0A7B88 


USER 


KGN01 


USRL 


05 GPNM 


SYSDA 


ATR1 EOOO ATR2 0000 CPU 00018300 






SWP 


C04C33FD 


LTIM 008A0560 TCPU 


00000000 


TSWP 00000000 TCON 00000000 TC01 00000000 






RLGB 


0CCA8700 


UPT 000A86F0 UPTL 


0010 


PSV1 0000 RSV2 COOOOCOO USE1 00000000 






USE2 


CCCCG3C0 










TAXE 


0A6C30 


TMFLD 


00 


PPSAV 0CD710 ABOPSV 00000000 WCSA 00 SIZE 12 STAB 403* 






EP 


00C0B83A 


LCPSW 00040000 ROPSW 0000? 


3C2 USE 00 IOE 000000 WCF 00 






LINK 


000000 


GRO COOOOOOC GR1 


00000000 GR2 OJOOOOOO GR3 COOOOOOO GR4 00000000 






GR5 


00000000 


GR6 OCOOOOCO GR7 


00000000 GR8 00000000 G«9 00000000 G«10 00000000 






GR11 


00000000 


GR12 00000000 GR13 OCOCOOOO GR14 00000000 GR15 00000000 NIQE OOOOOOOC 






INK 


000A6014 


PRM1 00000000 IRB 


0O0A6CBO TCB 000A6CB0 TLNK 000A6068 XPSW 00000000 






EXIT 


00000000 


STAT 00000000 PARM 000ABBF8 TAIE C00CCF7C IBUF OOOOOOOC USER OOOCCDB* 






Figure 24. Sample of TSO Control Block Format (Part 3 of 3) 



LUS hhhh 

The maximum number of TSO users that 
may be logged onto the system. For 
additional users to be logged onto the 
system, the value of LUS must be 
greater than the value in CUS. LUS 
cannot exceed the value in NTJ. LUS 
is set by the time sharing control 
task (TSO. This field is initially 
set to the same value as MUS; however, 
if TSO encounters I/O errors while 
swapping users in and out, the time 
sharing control task reduces this 
value to limit the number of TSO 
users. 



NTJ hhhh 

The number of time- sharing job blocks 
(TJBs) and terminal status blocks 
(TSBs) allocated when TSO was started. 
The dummy TJB for the terminal job 
identification (TJID) equal zero is 
not included. The value of LUS cannot 
exceed this number. 



SZU hhhh 

The number of bytes in the time 
sharing job block (TJB) . 

CTR hhhh 

Contains the number of region control 
blocks (RCBs) allocated when TSO was 
started. This number cannot be 
increased after the TSO system is 
started. 

MUS hhhh 

The maximum number of users that may 
be logged onto a TSO system. This 
field is set by the START and MODIFY 
commands issued by the operator. 

SAV hhhhhhhh 

The beginning address of three 18-word 
save areas used by the time sharing 
control task (TSC) , the time sharing 
interface program (TSIP), and the time 
sharing dispatcher. 

ECB hhhhhhhh 

The address of the table control block 

(TSECBTAB) which contains the ,event 
control blocks (ECBs) used to post the 
time sharing control task (TSC) , the 
region control tasks (RCTs), and the 
terminal input output coordinator 

(TIOC). 

SIA hhhhhhhh 

The address of the time sharing 
interface area (TSIA) . 

ICB hhhhhhhh 

The address of the time sharing 
interface control block (TSICB) . 



101 hhhhhhhh 

The address of the branch entry point 
IKJEAI01 in the time sharing interface 
program (TSIP). 

TQE hhhhhhhh 

The address of the timer queue element 
(TQE) used by TSO for time slicing. 

102 hhhhhhhh 

The address of the entry point 
IKJEAI02 in the time sharing 
dispatcher. 

103 hhhhhhhh 

The address of the entry point 
IKJEAI03 in the* time sharing 
dispatcher. 

DO 2 hhhhhhhh 

The address of the entry point to the 
TSO driver routine (IKJEAD0 2), or the 
equivalent entry in a user written 
routine. 

LCQ hhhhhhhh 

The address of the f i rst element in 
the logon communications queue. 

TRB hhhhhhhh 

The first address in the trace control 
block chain. This address is 
established and used by the statistics 
collection routine. It is set to zero 
by the time sharing control task 
(TSC) . 

LPA hhhhhhhh 

The address of the first contents 
directory entry (CDE) in the time 
sharing link pack area. 

SLF hhhhhhhh 

The address of the system-initiated 
logoff routine. 

TSC hhhhhhhh 

The address of the task control block 
(TCB) for the time sharing control 
task (TSC) . 

SPL hhhhhhhh 

The address of the start parameter 
list. 

RSZ hhhh 

The minimum number of 2K blocks for a 
region during logon. 

RSV hhhh 

Reserved for future use. 

SVT hhhhhhhh 

The contents of the SVC table entry 
used by the time sharing interface 
program (TSIP). 
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SVQ hhhhhhhh 

The contents of the SVC table entry 
used by the TCAM/TIOC interface 
program. 

ABN hhhhhhhh 

The address of the out-of-main storage 
abnormal termination routine 
(IKJEAT07). The routine is resident 
in main storage. 

DO 3 hhhhhhhh 

The entry point address to the TSO 
driver MODIFY routine (IKJEAD03), or 
the equivalent entry point address in 
a user written routine- 

FLM hhhhhhhh 

The entry point address IKJEFLM for 
the system initiated logoff routine. 

QTP hhhhhhhh 

The entry point address IKJGGQTl for 
the branch entry to the TCAM interface 
program (QTIP). 

TO 8 hhhhhhhh 

The entry point address to the TSO 
command routine (IJEAT08) for TSO 
dumps taken by the time sharing 
control task (TSC) TSO dumps. 

DMP hhhhhhhh 

The address of the TSO dump control 
block. 

TO 6 hhhhhhhh 

The TCB address of the TSO dump 
routine (IKJEAT06) for the time 
sharing control task (TSC) modify 
routine. 

TIME SHARING REGION CONTROL BLOCK (RCB) 
FORMATTING : A region control block (RCB) 
contains information that is unique to a 
time sharing region. There is one RCB for 
each time sharing region. The RCBs reside 
in the time sharing control tasks region, 
they are contiguous, and they are created 
during initialization of the time sharing 
controller. 

RCB hhhhhh 

The address of the RCB. ^ 

RCT hhhhhhhh 

The address of the task control block 
(TCB) for this region control task 
(RCT) . The TCB contains the address 

of the partition queue element (PQE) 

that defines the region. 

ECB hhhhhhhh 

The event control block (ECB) on which 
this region control block (RCB) waits. 
This ECB must be posted before this 
region control task (RCT) can perform 
one of its functions. 



DIECB hhhhhhhh 

The event control block (ECB) that is 
posted upon completion of this region 
control task (RCT) . The time sharing 
control task (TSC) waits for this ECB 
to be posted. 



TJID hhhh 

The terminal job identification (TJID) 
for the time sharing job currently 
executing in this region. 



RSIZE hhhh 

The number of 2K blocks in this 
region. It is set by the time sharing 
control task (TSC) when the time 
sharing system is started. 

LSQSZ hhhh 

The number of 2K blocks in the local 
system queue space (LSQS) for this 
region. It is set by the time sharing 
control task (TSC) when the time 
sharing system is started. 

NMBR hh 

The identification number assigned to 
this region. 

PKEY hh 

The protect key (PKEY) for the time 
sharing job currently executing in 
this region. 

UMSMN hh 

The number of entries in the main 
storage map which describes the main 
storage image that was initialized 
during logon. 

FLG hh 

This field contains the first byte of 
the region control block (RCB) flags. 
The flags indicate various functions 
to be performed by the region control 
task (RCT) and time sharing control 
task (TSC). These flags are set by 
the time sharing interface program 
(TSIP), the time sharing control task 
(TSC) # and the terminal input/output 
coordinator (TIOC) . These flags are 
tested and reset by the region control 
task (RCT) and the time sharing 
control task (TSC) . 



1. 



RCBFQO: Bit is the 
quiesce flag. When set, 
this flag indicates that the 
current user of this region 
should be quiesced. 

RCBFSO: Bit 1 is the swap 
out flag. When set, this 
flag indicates that the 
current user should be 
swapped out. 
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1. .... RCBFSI: Bit 2 is the swap 
in flag. When set, this 
flag indicates that the 
current user of this region 
should be swapped in. The 
user's terminal job 
identification (TJID) is in 
the region control block 
(RCB) . 

, .1 .... RCBFRS: Bit 3 is the 

restore flag. When set, 
this flag indicates that the 
user, whose terminal job 
identification (TJID) is in 
the region control block 

(RCB) , should be restored by 
the region control task 

(RCT) . 



The flag is set to one when 
the region control task is 
initialized; it is set to 
zero when the region control 
task is terminated. 

.1 .... RCBSTR1: Bit 3 indicates 

that a region start has been 
requested, and the region 
control task should be 
attached. 

. . 1... RCBSTR2: Bit 4 indicates 

that a region start has been 
requested, and a swap logon 
image should be created. 

, .. .xxx Bits 5 through 7 are 

reserved for future use. 



1... RCBOCAB: Bit U set 
indicates that the 
out-of-main storage abnormal 
termination routine was 
invoked . 

.x.. Bit 5 is reserved for future 
use. 



..1. 



RCBFAT: Bit 6 is the 
attention exit flag. When 
set, this flag indicates 
that an attention exit has 
been requested for one or 
more users. 

RCBFND: Bit 7 is the END 
region control task (RCT) 
flag. When set, this flag 
indicates that the region 
control task (RCT) should 
terminate normally and 
return control to the time 
sharing control task (TSC) . 



FLG2 hh 

This field contains the second byte of 
the region control block (RCB) flags. 
See FLG. 



1. 



.1, 



.1. 



RCBFSE: Bit is the swap 
end flag. When set, this 
flag indicates that the 
swap- in operation for the 
current user of this region 
is complete. 

RCBSTOP: Bit 1 is the 
region stop flag. When set, 
this flag indicates that a 
request has been made to 
stop the region. Every user 
of this region will be 
logged off. 

RCBACTV: Bit 2 indicates 
the active status of the 
region control task (RCT). 



FBQE hh 

The number of free block queue 
elements (FBQEs) for this region. 

UTTMQ hhhh 

The relative track address (TT) of the 
map queue pointer. The map queue 
pointer describes the location of the 
region's initialized logon image on 
the swap data set. 

CUSE hhhh 

The number of users logged on to use 
this region. The time sharing control 
task (TSC) increments the count before 
disconnect (DISC) and decrements the 
count during logon. 

EXTNT hhhhhhhh 

The address of the initialized time 
sharing job block extension (TJBX). 
The TJBX is created during the logon 
initialization for this region. 

UMSM hhhhhhhh 

The address of the user main storage 
map. This map describes the 
initialized logon main storage image 
for this region. 

SDCB hhhhhhhh 

The address of the swap data set 
control block (SDCB). This block 
points to the location of the 
initialized logon image on the swap 
data set for this region. 

PQE hhhhhhhh 

The address of the partition queue 
element (PQE) pointer in the system 
queue space (SQS) . The PQE describes 
the main storage space assigned to 
this region. The PQE pointer is used 
to manipulate main storage when (1) 
this region control task's (RCT's) 
region is obtained during start time 
sharing initialization and (2) this 
region control task's (RCT's) region 
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is freed during region control task 
termination* 

PRG hhhhhhhh 

PRG1 hhhhhhhh 

PRG2 hhhhhhhh 

These three words constitute the SVC 
I/O purge parameter list, For further 
information, see the "Purge Macro 
Instruction" in the publication IBM 
System/360: System Programmer's 
Guide . GC28-6550. 

QPL hhhhhhhh 

The address of the quiesce I/O 
parameter list. 

STECB hhhhhhhh 

An event control block (ECB) . During 
a subsystem recovery, the time sharing 
control task (TSC) waits for this ECB 
to be posted by the region control 
task (RCT) . The posting is done 
during end processing. 

RCOVR hhhhhhhh 

These bits indicate the current 
recovery status of the region control 
task (RCT) in the event of a subsystem 
failure, 
byte 

1 RCBRCOVR: Bit set 

indicates that the status 
bits in the following 3 
bytes are valid. 

.xxx xx.. Reserved for future use. 

x. RCBWTOR: WTOR restore 

processing complete. 



byte 1 - 
1.. 



1. 



• • JL • 



. i. 



x RCBTACMP: Transient area 
restore processing complete. 
- RCBRSFLG 

RCBRSTRT: Bit set 

indicates a restore. 

RCBTCBDN: Bit 1 set 
indicates that the task 
control blocks (TCBs) have 
been requeued. 

RCBQELCM: Bit 2 set 
indicates that, the queue 
element CQEL) restore 
processing is complete. 

RCBTQECM: Bit 3 set 
indicates that the timer 
queue element (TQE) restore 
processing is complete. 

RCBRQIQC: Bit 4 set 
indicates that both the 
request queue element (ROE) 
and the interrupt queue 
element (IQE) restore 
processing is complete. 



.1.. RCBIORSC: Bit 5 set 

indicates that' the I/O 
restore processing is 
complete. 

.... ..xx Bits 6 and 7 are reserved 

for future use. 

byte 2 — RCBQUFLG 

1,.. RCBQUSTR: Bit set 

indicates that quiesce has 
started. 

.1. RCBIOSTR: Bit 1 set 

indicates that the first 
entry into the I/O purge 
routine is complete. 

..1. RCBTADON: Bit 2 set 

indicates that the transient 
area quiesce is complete. 

...1 .... RCBWTORD: Bit 3 set 

indicates that the write to 
operator with reply (WTOR) 
quiesce is complete. 

.... 1... RCBQELDN: Bit 4 set 

indicates that the queue 
element (QEL) quiesce is 
complete. 

.... .1.. RCBIODON: Bit 5 set 

indicates that the second 
entry I/O purge is complete. 

..1. RCBTQEDN: Bit 6 set 

indicates that the timer 
queue element (TQE) quiesce 
is complete. 

1 RCBRQIQD: Bit 7 set 

indicates that both the 
request queue element (RQE) 
and the interrupt queue 
element (IQE) are complete. 



byte 3 

JL m m m 



RCBSWTCH: Bit indicates 
the method of search used by 
various subroutines in 
IKJEAT07. When equal to 
zero, all system users are 
purged according to the 
terminal job identification 
(TJID) . When equal to one, 
all users in this region are 
purged as indicated by the 
region control block 
addresses. 



,1 RCBSWTON: When bit 1 is set 

along with bit being set, 
all system users are purged. 
A search is made according 
to the terminal job 
identification (TJID) and 
the request control block 
(RCB) . 
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..xx xxxx Bits 2 through 7 are 

reserved for future use. 

CON ID hh 

The routing code of the console that 
issued the last START, MODIFY, or STOP 
command. 

RESV hhhhhh 

Reserved for future use. 

* MAIN STORAGE MAP (UMSM) FORMATTING ; 
. UMSM is used in the swap operation. 
One user main storage map exists for each 
possible time sharing user. The UMSM 
contains a series of consecutive one-word 
extent fields (ADDR-LN). Each one-word 
extent contains a ha If word address field 
(ADDR) and a halfword length field (LN) 
that describe the main storage space 
allocated to the time sharing user. The 
number of UMSM extents has established 
defaults that can be modified by the 
operator when he starts the time sharing 
system. The number of extent entries is 
stored in the time sharing job block (TJB) 
at TJBUMSMN. Unused extent fields contain 
zeros . 

UMSM hhhhhh 

The address of the user main storage 
map. 

ADDR-LN hhhhhhhh 
bytes and 1 

Begin Address: This field contains 
the two high order bytes of the 
beginning address of the main storage 
segment allocated to the time sharing 
user. Since main storage is allocated 
in 2K blocks, the low order byte is 
always zero and, therefore, need not 
be kept in a control block. 

bytes 2 and 3 

This field contains the two high-order 
bytes designating the length of the 
main storage space allocated to the 
time sharing user. Since main storage 
is allocated in 2K blocks, the 
low-order byte is always zero and, 
therefore, need not be kept in a 
control block. 

SWAP DATA CONTROL BLOCK (SWAP DCB) 
FORMATTING : The swap data control block 

(SWAP DCB) is used whenever a time sharing 
user's region is swapped into or out of 
main storage. Each region control task 

(ROT) has one swap data control block. 
Following the address of the swap data 
control block is the contents of the main 
storage data that was written on the swap 
data set . 

SWAP DCB hhhhhhhh 

The address of the swap data control 
block. 



TIME SHARING JOB BLOCK (TJB) FORMATTING : 

The time sharing job block (TJB) contains 
status information about the time sharing 
user. The TJB is retained in main storage 
while the user is swapped out. One time 
sharing job block exists for each possible 
simultaneous time sharing user. The space 
for the TJB is obtained from the time 
sharing control task (TSC) region during 
time sharing initialization. Status 
information about terminals related to this 
TJB is contained in the terminal status 
block (TSB). The address of the terminal 
status block is the first word of the TJB. 



TJB hhhhhh 

The address of this TJB. 



TSB hhhhhhhh 

The address of the terminal status 
block (TSB) that owns this terminal 
job. If zero, this job was started by 
an operator command. 



ATTN hh 

A count of the unprocessed attention 
interrupts for this job. 



STAX hh 

The number of scheduled specify 
terminal attention exits (STAXs). 

STAT hh 

This field contains flags that 
indicate the status of the time 
sharing job. 

1 TJBNJB: Bit set indicates 

that this TJB is currently 
unused. 

.1 TJBINCOR: Bit 1 set 

indicates that this user is 
currently in main storage. 

..1 TJBLOGON: Bit 2 set 

indicates that the logon 
start has been set by the 
terminal input output 
coordinator (TIOC) during a 
dialup to request a logon. 
This bit is reset by the 
time sharing control task 
(TSC) . 

...1 ...... TJBIWAIT: Bit 3 set 

indicates that the terminal 
job is in an input wait 
state. 

.... 1... TJBOWAIT: Bit 4 set 

indicates that the terminal 
job is in an output wait 
state. 



116 Programmer 1 s Guide to Debugging (Release 21) 



1-. TJBSILF: Bit 5 set 

indicates that the user is 
to be logged off the system. 
This bit is set by the 
IKJSILF subroutine and 
tested by the region control 
task (RCT) restore routine 
that posts the logon ECB. 
This bit is tested and reset 
by the logon/logoff routine. 

1. TJBDISC: Bit 6 set 

indicates that a request has 
been made to the terminal 
input output coordinator 
(TIOC) to disconnect the 
line. 

x Bit 7 is reserved for future 

use. 

STAT 2 hh 

These flags indicate the status of the 
time sharing job. 



UMSM hhhhhhhh 

The address of the user main storage 
map (UMSM) for this job. 

SDCB hhhhhhhh 

The address of the swap data control 
block (DCB) for this job. 



1.. 



.1. 



TJBHUNG: Bit set 
indicates that the user's 
communication line 
disconnected. 

TJBHOLD: Bit 1 set 
indicates that an output 
wait (OWAIT) exists because 
of a hold option. 

TJBOCAB: Bit 2 set 
indicates an out-of-main 
storage abnormal termination, 
has occurred for this user. 

TJBRNAV: Bit 3 set 
indicates that the user 
cannot be logged onto the 
time sharing system because 
(1) a machine check occurred 
in the user's region or (2) 
the region is too small for 
the user. 

TJBSURSV: Bit 4 set 
indicates that on the next 
swap in the swap unit is not 
marked as available for the 
user. 



UTTMQ hhhh 
1... , 



TJBUTTMP: Bit of byte 
set indicates a parallel 
swap. 



.111 1111 Bits 1 through 7 of byte 
along with byte 1 contain 
the offset into the map 
queue. The map queue 
contains a chain of 
allocation units for this 
user on the swap data set. 
The address of the queue is 
in the UTTMQ field of the 
TSO region control block 
(RCB) . 

RSTOR hh 

This field contains the status flags 
used by the region control task (RCT) 
restore operation. 

1 TJBOWP: Bit set indicates 

to the terminal input output 
coordinator (TIOC) to end 
the output wait (OWAIT) 
condition. 

.1 TJBIWP: Bit 1 set indicates 

to the terminal input output 
coordinator (TIOC) to end 
the input wait (IWAIT) 
condition. 

. .x Bit 2 is reserved for future 

use. 

...1 TJBLOGP: Bit 3 set 

indicates that the event 
control block (ECB) waited 
for by the logon image 
should be posted. This flag 
is set by the time sharing 
control task (TSC) logon 
routine and by the IKJSILF 
subroutine. 



.... .xxx Bits 5 through 7 are 

reserved for future use. 

EXTNT hhhhhhhh 

The address of the terminal job block 
extension (TJBX) when it is in main 
storage. 

RCB hhhhhhhh 

The address of the region control 
block (RCB) for this job. 



1... TJBLWAIT: Bit 4 set 

indicates that if the user 
is not made ready by restore 
processing, he should be 
swapped out again. 

.x.. Bit 5 is reserved for future 
use. 

..1. TJBFAT: Bit 6 set indicates 
that an attention exit is 
requested for this user's 
job. 
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,x Bit 7 is reserved for future 
use. 



UMSMN hh 

The number of entries in the user main 
storage map (UMSM). 



,1 TJBMSESj Bit 2 set 

indicates that # when a 
terminal session is 
initiated or terminated a 
message is displayed on the 
operator console. 



USER cccccccc 

The user id of the user who owns this 
job. This field may have trailing 
blanks when the user identification 
contains less than eight characters. 



IPPB hhhhhhhh 

An address pointer to the beginning of 
a chain of inter-partition post blocks 
that indicate the event control blocks 
(ECBs) to be posted by the restore 
operation. 



NEWID hh 

Identifies the region where the user 
should be logged on. When this field 
is zero, the TSO driver should select 
the region. When this field is set by 
the end-of-routine for logon/logoff, 
it identifies the new region to which 
the user will be shifted. 



,1 .... TJBMSPA: Bit 3 set 

indicates that the available 
space on a direct access 
device is to be displayed on 
the operator console as part 
of the demount message. 



.... 1... TJBMSTAj Bit 4 set 

indicates that, at the end 
of a job or job step, 
certain data set disposition 
information should be 
printed with the demount 
messages. These 
dispositions are: KEEP, 
CATLG, or UNCATLG. 

.... .xxx Bits 5 through 7 are 

reserved for future use. 

RSV hhhhhh 

Reserved for future use. 



FLUSL hh 

Reserved for future use. 



TJID hhhh 

This field contains the terminal job 
identification (TJID) for this time 
sharing job. 

MONI hh 

These flags indicate various 
processing functions that cause 
operator messages to be sent to this 
terminal. The flags are set and reset 
when the terminal user issues the 
MONITOR subcommand of the OPERATOR 
command. 



1. 



.1. 



TJBMDSN: Bit set 
indicates that the first 
non-temporary data set 
allocated to a new volume 
should be displayed as part 
of the mount and keep 
messages. 

TJBMJBN: Bit 1 set 
indicates that the name of 
each job is to be displayed 
on the console when each job 
is initiated and terminated, 
and that the unit record 
allocations are to be 
displayed when a job step is 
initiated. 



TERMINAL STATUS BLOCK (TSB) FORMATTING ; 
Each terminal status block (TSB) contains 
status information about one terminal user. 
The terminal input output coordinator 
(TIOC) uses this information. During 
system initialization, one TSB is created 
for each possible user. The main storage 
space is obtained in one contiguous block 
for all of the TSBs in the region of the 
time sharing control task (TSC) ; this 
contiguous string of TSBs is called the TSB 
table. The origin pointer to the TSB table 
is the TIOCTSB field in the TIOCRPT. 

TSB hhhhhh 

The address of this terminal status 
block (TSB). 

STAT hh 

This field contains the terminal 
status indicator flags. 



1. 



..1, 



TSBINUSE: Bit set 
indicates that this TSB is 

beir>g used. 

TSBLWAIT: Bit 1 set 
indicates that the terminal 
keyboard is locked due to a 
lack of input buffer space. 

TSBDSPLY; Bit 2 set 
indicates that this TSB 
represents a terminal which 
is a graphic device. 
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TSBNOBUF: Bit 3 set 
indicates that TPUT found no 
time sharing buffers. 



... 1... TSBITOFF: Bit 4 set 

indicates that this user 
wishes to prevent 
inter- te rmi na 1 
communications. 



.1.. TSBDISC: Bit 5 set 

indicates that this TSB has 
been processed by logoff. 

•.x. Bit 6 is reserved for future 
use. 



1 TSBATNLD: Bit 7 set 

indicates an attention for 
an input line deletion. 



TJB hhhhhh 

The address of the time sharing job 
block (TJB) currently used by this 
terminal. This field contains zeros 
when this terminal is not associated 
with a time sharing job block. 

FLG1 hh 

This field contains terminal status 
flags. 

1... .... TSBANSR: Bit set 

indicates that an attention 
simulation is requested. 

. 1.. .... TSBOFLSH: Bit 1 set 

indicates that the output 
trailer queue is to be 
flushed. This bit is set by 
TCLEARQ. 

..1. .... TSBOWIP: Bit 2 set 

indicates that a TPUT 
operation is in progress. 

...1 TSBWOWIPs Bit 3 set 

indicates that a task is 
waiting for another task to 
complete a TPUT operation. 

.... 1... TSBIFLSH: Bit ^ set 

indicates that an input 
queue flush is in progress. 

1.. TSBTJOW: Bit 5 set 

indicates that this user is 
already using the maximum 
number of output buffers 
that can be allocated. This 
TSB waits on event control 
block (ECB) for this TCB. 
This bit is set by a TPUT 
macro instruction with a 
terminal job identification 
CTJID) . 



.... ..x. Bit 6 is reserved for future 

use. 

.... ...1 TSBTJBF: Bit 7 set 

indicates that no time 
sharing buffers were 
available when the SVC for 
TPUT with the terminal job 
identification (TJID) was 
issued. The system waits 
for the TJB event control 
block (ECB) to be posted. 

WTSB hhhhhh 

Reserved for future use. 

LNSZ hh 

The number of characters that can be 
printed on one line for this terminal. 
This field is set by either logon or 
STSIZE. 

OTBFP hhhhhh 

The address of the trailer buffer if 
the heading buffer for a message has 
been removed from the message queue. 
This field is reset to zeros when the 
message has been completely moved to 
the TCAM buffers. 

NOBF hh 

The number of buffers on the output 
queue. 

OBFP hhhhhh 

The address of the first buffer on the 
output buffer queue. 

BRKFL hh 

These flags indicate the status of the 
communication line. 

1 TSBBIPI: Bit set 

indicates to the TSINPUT 
that a partial line exists 
for prompting. Set by 
TSOUTPUT. 

.1 TSBAUTON: Bit 1 set 

indicates that automatic 
input line numbering is 
requested. 

..1. TSBBRKIN; Bit 2 set 

indicates that TPUT is using 
the breakin option and a 
partial line was assigned to 
this function. This bit is 
set by TSINPUT. TSINPUT is 
a TCAM subtask. 

...1 .... TSBAULST: Bit 3 set 

indicates that automatic 
line numbering has started. 

.... 1... TSBAUTOC: Bit 4 set 

indicates that automatic 
character prompting is used. 
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.... .1,. TBSTAUT: Bit 5 set 

indicates that the user is 
being prompted with the next 
line number. 

.... ..11 TSBSATN1: Bits 6 and 7 

contain a count of the 
number of characters used to 
simulate attention. 

ITBFP hhhhhh 

The address of the first buffer in the 
trailer input buffer chain. 



NIBF 



The number of buffers on the input 
queue. 



IBFP hhhhhh 

The address of the first buffer in the 
input buffer queue chain. 

CLEAR hh 

This field contains terminal status 
flags. 

1... TSBATTN: Bit set 

indicates that an attention 
from this terminal has been 
ignored. 

.1 TSBTJMSG: Bit 1 set 

indicates that TSOUTPUT is 
processing a terminal job 
identification (TJID) 
message. 

..1 TSBSPIT: Bit 2 set 

indicates that breakin 
prompt and automatic prompt 
are suppressed. 

...1 .... TSBNBKSP; Bit 3 set 

indicates that the next 
character in the user's 
buffer is a backspace 
character. 

.... xxxx Bits 4 through 7 are 

reserved for future use. 

QCB hhhhhh 

The address of the queue control block 
(QCB) that contains the destination 
for the message being sent. 

ECB hhhhhhhh 

The event control block (ECB) at which 
the inter-terminal communication (TPUT 
with TJID) waits (1) when there are no 
time sharing buffers, ( 2) when the 
TSBOWIP bit is set, or (3) when the 
TSBOQHLD bit is set. 

TJID hhhh 

The terminal job identification (TJID) 
of the task waiting on this TCB's 
event control block (ECB). 



STCC hhhh 

These two bytes define special purpose 
characters that may be redefined by 
the terminal user. 

byte 

TSBLNDCC: This byte contains the line 
delete character. 

byte 1 

TSBKSPCC: This byte contains the 
character delete character. 

ATNLC hhhh 

The number of successive lines of 
printed output between attention 
simulation reads. 

ATNTC hhhh 

The number of seconds between 
attention simulation reads. 

LNNO hh 

When a graphic terminal device is 
used, this is the number of line that 
can be displayed. 

BLNK hh 

Reserved for future use. 

ASRCE hhhh 

This field contains the same 
information as the PRFSRCE field in 
the TCAM buffer prefix. 

ATNCC cccc 

This field contains from one to four 
characters that are used to simulate 
attention. Some of the character 
positions may contain blanks. 

AUTOS hhhhhhhh 

This field initially contains the 
starting line number for the first 
input line. While the line of input 
information is being received from the 
terminal user, this field is updated 
to contain the value of the current 
line number. 

AUTOI hhhhhhhh 

This field contains the value that is 
used to automatically increment the 
value of the input line numbers. This 
field can be modified by the terminal 
user. 

ERSDS cccc 

When a graphic terminal device is 
used, this word contains the 
characters used to erase the display 
screen. 

TIME SHARING JOB BLOCK EXTENSION (TJBX) 
FORMATTING : The time sharing job block 
extension (TJBX) contains user job 
information that can be rolled out to the 
swap data set with the user's job. The 
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TJBX resides in the local system queue 
space (LSQS) for the region. The TJBX 
location is pointed to by the third word of 
the time sharing job block (TJB). The 
space for the TJBX is obtained by the 
region control task (RCT) during 
initialization. 



TJBX hhhhhh 

The address of the TJBX. 



XFST hhhhhhhh 

The address of the logon TCB. The 
logon TCB is the first TCB on the 
user's ready queue. 

XLAST hhhhhhhh 

The address of the last TCB on the 
user's ready queue. 

XDSE hhhhhhhh 

The address of the data set extension 
(DSE) used by TSO dynamic allocation. 

XSVRB hhhhhhhh 

The address of the first supervisor 
request block (SVRB) purged from the 
transient area queue. 

XRQE hhhhhhhh 

The address of the first request queue 
element (RQE) purged from the 
asynchronous exit queue. 

XIQE hhhhhhhh 

The address of the first interrupt 
queue element (IQE) purged from the 
asynchronous exit queue. 

TAXE hhhhhhhh 

The address of the queue of terminal 
attention exit elements (TAXEs) used 
to schedule the attention exits. 

XLECB hhhhhhhh 

The logon event control block (ECB) 
that was posted by the region control 
task (RCT) to activate logon/logoff. 

XPSWD cccccccc 

The password entered by the terminal 
user during logon. If the password 
contains less than eight 'characters, 
the field is padded to the right with 
blanks. The entire field contains 
blanks when the user is not required 
to enter a password. 

XATTR hhhhhhhh 

The address of the chain of attribute 
control blocks (ATRCBs). 

XAIQE hhhhhhhh 

The address of the attention interrupt 
queue element (IQE) currently being 
processed by the attention prologue. 



XQPL hhhhhhhh 

The address of the quiesce parameter 
list (QPL). 

XNQPE hhhh 

The number of entries in the quiesce 
parameter list (QPL). 

XNTCB hhhh 

The number of task control blocks 
(TCBs) active in the user's job step. 
When the value in XNTCB exceeds XNQPE, 
the quiesce parameter list is 
enlarged. 

XLQPL hhhh 

The number of bytes in the quiesce 
parameter list. 

RSV hhhh 

Reserved for future use. 

XACT hhhhhhhh 

The relative track and record address 
(TTR) for the account control table 
(ACT) on SYSJOBQE. 

XAECB hhhhhhhh 

This field contains either: (1) The 
address of the logon/logoff event 
control block (ECB) when logon 
processing begins. (2) The address of 
the command scheduling block (CSCB's) 
cancel event control block (ECB) after 
the CSCB is created. 

XKEYA hhhhhhhh 

The address of the storage key save 
area. 

PROTECTED STEP CONTROL BLOCK (PSCB) : The 
protected step control block (PSCB) 
contains accounting information related to 
a single user. All timing information is 
in software timer units. A software timer 
unit is equal to 26.04166 microseconds. 

PSCB hhhhhh 

The address of this PSCB. 

USER ccccccc 

These seven bytes contain the user id 
entered by the terminal user during 
logon. If necessary, it is padded to 
the right with blanks. This field 
uniquely identifies each terminal user 
in the time sharing system. 

USRL hh 

The number of nonblank characters in 
the use rid. 

GPNM cccccccc 

An eight-byte group name initialized 
by logon from the user attribute data 
set (UADS). When a name is not 
available from UADS, the unit name 
used by the dynamic allocation 
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interface routine (DAIR) is used, if a 
name is required. 

ATR1 hhhh 

Sixteen bits used to define terminal 
user attributes. 

byte 

1 PSCBCTRL: Bit set 

indicates that the user may 
use the OPERATOR command. 

.1 PSCBACCTs Bit 1 set 

indicates that the user may 
use the ACCOUNT command. 

-.1 PSCBJCL: Bit 2 set 

indicates that the user may 
use the SUBMIT, STATUS, 
CANCEL, and OUTPUT commands. 

...x xxxx Bits 3 through 7 are 

reserved for future use. 



RLGB hhhhhhhh 

The address of the re-logon buffer 
block used by logon as a pointer to 
the re- logon command buffer. 

UPT hhhhhhhh 

The address of the user profile table 
(UPT). 

UPTL hhhh 

The number of bytes in the user 
profile table. 

RSV1 hhhh 

RSV2 hhhhhhhh 

RSV1 and RSV2 are a single six byte 
field that is reserved for future use. 

USE1 hhhhhhhh 

USE 2 hhhhhhhh 

USE1 and USE2 are a single eight byte 
field reserved for use by IBM 
customers. 



byte 1 

Reserved for future use. 

ATR2 hhhh 

bytes and 1 

Reserved for use by IBM customers. 

CPU hhhhhhhh 

The cumulative CPU time used by this 
terminal user during this session. 
The CPU field is set to zero during 
logon. 

SWP hhhhhhhh 

The cumulative time that this terminal 
user has been resident in the region. 
The SWP field is set to zero during 
logon. 

LTIM hhhhhhhh 

The actual time of day that this user 
logged on to the time sharing system 
for this session. 

TCPU hhhhhhhh 

The total CPU time used by this 
terminal user, excluding the current 
session. 

TSWP hhhhhhhh 

The total time that the terminal user 
has been resident in the region during 
this accounting period, excluding the 
current session. 

TCON hhhhhhhh 

TCOl hhhhhhhh 

TCON and TCOl are a single eight byte 
field. This field contains the total 
connect time for this terminal user 
during this accounting period, 
excluding the current session. 



TERMINAL ATTENTION EXIT ELEMENT (TAXE) 
FORMATTING : The TSO terminal attention 
exit element (TAXE) consists of a regular 
24 word interrupt request block (IRB) plus 
a TSO addendum. It is used to schedule an 
attention exit resulting from a terminal 
attention interruption. It is created, 
queued, and dequeued by the specify 
terminal attention exit (STAX) macro 
instruction. The main storage space for 
the TAXE is obtained in the local system 
queue space (LSQS) of the terminal user's 
region. 

TAXE hhhhhh 

The address of this TAXE when it is in 
main storage. 

TMFLD hh 

This field contains indicators for the 
time routines. 

1 Bit set indicates that the 

timer element was not 
queued . 

.1 Bit 1 set indicates that the 

local time-of-day option is 
used. 

..00 .... Bits 2 and 3 set to 

zero-zero indicate that the 
time interval was requested 
in timer units (26.04166 
microseconds) . 

..01 .... Bits 2 and 3 set to zero-one 
indicate that the time 
interval was requested in 
binary units. 

..10 .... Reserved for future use. 
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. . 11 ..... Bit 2 and 3 set to one-one 
indicate that the time 
interval was requested in 
decimal digits. 

.... 1... Bit 4 set indicates that the 
time interval has expired. 

.... .000 Bits 5 through 7 set to 

zero-zero-zero indicate an 
STIMER task time request. 

.... .001 Bits 5 through 7 set to 

zero-zero-one indicate an 
STIMER wait request. 

.... . 011 Bits 5 through 7 set to 
zero- one- one indicate an 
STIMER REAL time request. 

.... . 100 Bits 5 through 7 set to 

one-zero-zero indicate an 
STIMER task time request 
with a specified exit. 

Ill Bits 5 through 7 set to 

one-one-one indicate an 
STIMER REAL time request 
with a specified exit. 

Other combinations of bits 5 through 7 
are reserved for future use. 

PPSAV hhhhhh 

The starting address of the register 
save area for the problem program. 

ABOPSW hhhhhhhh 

This field displays the right half 
(bytes 4 through 7) of the program 
status word (PSW) that was active in 
the dump system during the execution 
of an ABEND or ABTERM routine. If 
these routines have not been invoked, 
then this field contains zeros. 

WCSA hh 

The number of requests waiting when 
termination occurred. 

SIZE hh 

The number of doublewords in this 
request block. 

STAB hhhh 

This field contains two bytes of 
status and attribute information. 



byte 1 

This byte contains various request 
block indicators. 



1... .... Bit set indicates that the 

RBLINK field points to the 
task control block (TCB) . 



.1 Bit 1 set indicates that the 

program related to the 
interrupt request block 
(IRB) is active. 



1. .... Bit 2 set indicates that 

this interrupt request block 
(IRB) is for an exit routine 
(ETXR). 

.x .... Bit 3 is reserved for future 
use. 

. . 00.. Bits 4 and 5 set to 

zero-zero indicate that the 
request queue element (IQE) 
is not to be returned. 

. . 01.. Bits 4 and 5 set to zero-one 
indicate that the interrupt 
request block (IRB) has 
queue elements for 
asynchronously executed 
routines that are request 
queue elements (RQEs) . 

, .. 10.. Bits 4 and 5 set to one-zero 
indicate that an interrupt 
queue element (IQE) is not 
to be returned at EXIT. 

, .. 11.. Bits 4 and 5 set to one-one 
indicate that the interrupt 
request block (IRB) has 
queue elements for 
asynchronously executed 
routines that are interrupt 
queue elements (IQEs). 

, .. ..1. Bit 6 set indicates that the 
request block storage can be 
freed at exit. 

, Bit 7 set to zero indicates 

a wait for a single event or 
all of a number of events. 



byte 

The TAXE is a type of interrupt 
request block (IRB). Byte zero 
identifies the type of request block; 
however, for the TAXE, only the IRB 
identification is used. 
01.. .... Bits and 1 set to zero-one 

indicate that this is an 
interrupt request block 
(IRB). 



1 Bit 7 set to one indicates a 
wait for a number of events 
that is less than the total 
number of events that are 
waiting. 



EP hhhhhhhh 

The address of the routine that was 
asynchronously executed. 
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LOPSW hhhhhhhh (Left half of PSW) 
ROPSW hhhhhhhh (Right half of PSW) 
This program status word (PSW) 
contains the status of the program 
represented by the request block being 
displayed when a new request block was 
created. Had the dumped system been 
allowed to continue processing 
normally, the operation would have 
been resumed with this PSW. 

USE hh 

This field contains the use count as 
used by ATTACH. 

IQE hhhhhh 

The address of the list origin for the 
interrupt queue element (IQE). 

WCF hh 

The number of requests that were 
pending when this dump was taken. 

LINK hhhhhh 

The address of the next request block 
(RB) on this RB queue. If this is the 
last request block on the queue, then 
this field contains the address of the 
task control block (TCB). 

GRO hhhhhhhh 



GR15 hhhhhhhh 

The general register save rea used by 
the supervisor. 

NIQE hhhhhhhh 

The address of the next available 
interrupt queue element (IQE). 

LNK hhhhhhhh 

The address of the next interrupt 
queue element (IQE). 

PRM1 hhhhhhhh 

The address of the parameter list for 
the asynchronous exit routine. 

IRB hhhhhhhh 

The address of the interrupt request 
block (IRB) to be scheduled next. 

TCB hhhhhhhh 

The address of the task control block 
(TCB) for this TAXE. 

TLNK hhhhhhhh 

The address of the next TAXE on this 
queue. 

XPSW hhhhhhhh 

The left half (bytes through 3) of 
the program status word (PSW) for the 
user attention exit routine. 



EXIT hhhhhhhh 

The address of the user attention exit 
routine. 

STAT hhhhhhhh 

This field contains status flags for 
this TAXE. 



byte 
1... 



TAXEFKEY: Bit set 
indicates that the task 
issuing the specify terminal 
attention exit (STAX) macro 
instruction is a problem 
program. 



.1.. .... TAXEMOD: Bit 1 set 

indicates that the task 
issuing the specify terminal 
attention exit (STAX) macro 
instruction is in problem 
program mode. 

..1 TAXEFFREQ: Bit 2 set 

indicates that the requested 
TAXE is not available for 
scheduling. 

...x xxxx Bits 3 through 7 are 

reserved for future use. 

bytes 1-3 

Reserved for future use. 

PARM hhhhhhhh 

The address of the parameter list for 
the specify terminal attention exit 
(STAX) macro instruction. 

TAIE hhhhhhhh 

The address of the terminal attention 
interrupt element. 

IBUF hhhhhhhh 

The address of the user input buffer. 

USER hhhhhhhh 

The address of the user parameter list 
from the specify terminal attention 
exit (STAX) macro instruction. 

Task Control Block Summaries 

If, during the course of program execution, 
the IMDPRDMP program formatted the major 
system control blocks of more than one MVT 
or MFT task, a summary of each displayed 
task's TCB is presented at the end of the 
control block portion of the dump listing. 
Depending upon the operating system option 
under which the dumped task was operating, 
either the MVT/MFT-with-subtasking TCB 
summary format (Figure 25) , or the abridged 
MFT- without-subtas king TCB summary format 
(Figure 26) is presented. 

Both summary formats are identified by 
two lines of heading information. The 
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first heading line displays the optional 
dump listing title, the name of the module 
that invoked the dump, and the date and 
time that the information was captured from 
the dumped system- The second line of 
heading displays the identifying phrase 
***** TC B SUMMARY ****." 

The individual TCB summaries contain the 
following information: 



MVT or MFT with Subtaskinq TCBs ; Are 
summarized in the two-line array 
illustrated in Figure PROUT-9 and described 
below: 

JOB cccccccc 

The JOB field in the first line of 
each task control block array displays 
to the user the eight-character name 
of the job associated with the TCB. 

STEP cccccccc 

The STEP field shows the eight- 
character name of the job step as it 
appeared on the label field of the 
EXEC JCL statement associated with the 
step. 

TCB hhhhhh 

The starting address of the task 
control block- 

CMP hhhhhhhh 

This field shows the ABEND indicators 
and user and system completion codes 
associated with this TCB. (See the 
relevant TCB discussion for the 
contents of this field.) 

NTC hhhhhhhh 

This word contains the address of the 
TCB that occurred previous to this one 
on the originating task's subtask 
queue. If the TCB being summarized 
was the first on the queue, this field 
displays zeros. 

OTC hhhhhhhh 

The OTC field displays the address of 
the TCB representing the originating 
task. 



LTC hhhhhhhh 

This field contains the address of the 
TCB that occurred last on the 
originating task's subtask queue at 
the time the dump was taken. If the 
TCB being summarized was the last on 
the subtask queue, this field contains 
zeros . 

PAGE ddd 

The page of the dump listing on which 
the formatted control blocks 
associated with this TCB, may be 
found. 



MFT Without Subtaskinq TCBs : Are 
summarized in the two line abridged array 
illustrated in Figure PROUT-10 and 
described below: 

JOB cccccccc 

The JOB field in the first line of 
each task control block array, 
displays to the user the 
eight-character name of the job 
associated with the TCB being 
summarized. 

STEP cccccccc 

The STEP field shows the 
eight -character name of the job step 
as it appeared in the label field of 
the EXEC JCL statement associated with 
the step. 

TCB hhhhhh 

The starting address of the task 
control block being summarized is 
given in the first field of this 
second line. 

CMP hhhhhhhh 

This field shows the ABEND indicators 
and user and system completion codes 
associated with the TCB. (see the MFT 
TCB discussion for a description of 
the contents of this field.) 

PAGE ddd 

The page of the dump listing on which 
the formatted control blocks 
associated with this TCB, are found. 
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M ODULE IMOSAOMP DATE 11/12/70 TIME 00.15 


PAGE 0032 












* * * * 


TCB SUM 


M A P. V * * 


* * 




JOB 


TCB 


STEP 
0085E8 CMP 


OOOCCOOO 


NTC 


COOOOOOO 


OTC 


00009CAO 


LTC 00000000 


PAGE 0004 




J03 


TCB 


STEP 
008728 CMP 


CCOCCCOO 


NTC 


00000000 


OTC 


00009CAO 


LTC 00000000 


PAGE 0005 




JTB 


TCB 


STEP 
008868 CMP 


OCOOOOOO 


NTC 


00000000 


OTC 


00009CAO 


LTC 00000000 


PAGE 0006 




JOB 


TCB 


STEP 

0089A8 CMP 


COOOOOOO 


NTC 


COOOOOOO 


OTC 


00009CA0 


LTC 00000000 


PAGE 0007 




JOB 


TCB 


STEP 
008AE8 CMP 


00000000 


NTC 


000000 00 


OTC 


00009CAO 


LTC 00000000 


PAGE 0008 




JOB 


TCB 


STEP 

008C28 CMP 


ooooocoo 


NTC 


COOOOOOO 


OTC 


00009CAO 


LTC COOOOOOO 


PAGE 0009 




JOB 


TCB 


STEP 
008D68 CMP 


0O00C000 


NTC 


00000000 


OTC 


00009CA0 


LTC 00000000 


PAGE 0010 




J3B 


TCB 


STEP 
008EA8 CMP 


ooooccoo 


NTC 


COOOOOOO 


OTC 


00009CA0 


LTC 00000000 


PAGE 0011 




JOB 


TCB 


STEP 

008FE8 CMP 


cooccooo 


NTC 


COOOOOCO 


OTC 


00009CA0 


LTC 00000000 


PAGE 0012 

















MODULE IMDSADMP DATE 11/12/70 TIME 00.15 


«>AGE 0033 








* * * * 


TCB SUM 


MARY * * 


* * 






JOB 


MASTER STEP SChEDULR 
TCB 009CA0 CMP OOOCCCCO 


NTC 


OOOCOOOO 


OTC 


OOOOOOOO 


LTC 


0002E268 


PAGE 


0022 




JCB 


MASTER STEP SCHEDULR 
TCB 0288C8 CMP 00000000 


NTC 


00009BA8 


OTC 


00009CAO 


LTC 


OOOOOOOO 


PAGE 


0025 




JOB 


J0B4 STEP GO 
TCB 02E0F8 CMP COOOOOOO 
TCB 02O1E8 CMP COOOOOOO 
TCB 32D4C0 CMP COOOOCOO 


NTC 
NTC 
NTC 


000288C8 
00000000 
00000000 


OTC 
OTC 
OTC 


00009CA0 
0002E0F8 
000201E8 


LTC 
LTC 
LTC 


0002D1E8 
00020400 
OOOOOOOO 


PAGE 
PAGE 
PAGE 


0027 
0028 
0029 




JOB 


WTR STEP CCE 

TCB 02E268 CMP CCOOCCOO 

TCB 02C108 CMP OGO0C300 


NTC 
NTC 


C002E0F8 
OOOOOOOC 


OTC 
OTC 


C00C9CA0 
C002E2*3 


LTC 
LTC 


00C2D10S 
00300030 


PAGE 

PAGE 


0030 

0031 m t _ — 




s*s 



















Figure 25. TSB Summary Sample for System That Operated Under MVT or MFT With Subtasking 
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OUMP LISTING 
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MOOULt: IMJSADMP DATE 11/12/70 TIME CO. 5C 

CB SUMMARY **** 


PAGE 0C22 


JOd 


STEP 
TCB 008 77d CMP 


OOOOCCCC 


PAGE 0001 






joa 


MASTER STEP SCHcDULR 
TCB J08558 v.MP occcoooo 


PAGE 0002 






JOd 


STEP 

TCS 008938 CMP 


OOOCCCOC 


PAGE 0C04 






jjd 


STEP 
TCB 008-Ud CMP 


OCOCOCOC 


PAGE 0005 






JOd 


MASTER STcP SCHcDULR 

TCB 0083tod CMP OOCOCCOC 

* 


PAGE 0C06 






JOd 


MASTER STEP SCHEDULR 
TCB 008;4d CM? OCOOCCOC 


PAGE 0007 






JOd 


*TR STEP PO 
TCB 008 148 wMP 


OCOOCCOC 


PAGE CC09 






JOd 


STEP 
TCB 008r4d CMP 


OOCOOCOO 


PAGE 0010 






JOd 


J0B5 STEP GJ 
TCB 009148 CMP 


OOOCQOOO 


PAGE C011 






JJd 


STEP 

TCB 009348 CMP 


OCCCOCOC 


PAGE 0013 






Jud 


STEP 

TCB 009548 CMP 


OOCOCCCC 


PAGE 0014 






JOB 


STEP 
TCB 009 148 CMP 


OOOCCOOC 


PAGE 0015 






JOd 


STEP 
TCB 009 948 CMP 


OCOOCCOC 


PAGE 0016 






JOd 


STEP 
TCB 009348 CMP 


OOCOOCOO 


PAGE 0017 






JOd 


STEP 

TCB CG90<»d CMP 


00000000 


PAGE C018 






JOd 


STEP 
TCB 009f48 CMP 


OOOCCCOO 


PAGE 0019 






JOd 


STEP 

TCB OOA140 CMP 


OCOOOOOC 


PAGE 0020 






JOd 


STEP 
TCd 00A34d CMP 


OOOCCOOC 


PAGE 0021 







Figure 26. TCB Summary Sample for Systems that Operated Under MPT Without Subt asking 



THE GENERAL FORMAT 

The IMDPRDMP program uses a general format 
to display the hexadecimal contents of main 
storage. The particular areas of main 
storage displayed are determined by the 
parameters entered after the PRINT user 
control verb. 

To identify various dump printouts, 
IMDPRDMP prints specific headings on each 
dump, such as ALLOCATED STORAGE, PRINT 
STORAGE, and NUCLEUS and SQA PRINT. A 
sample of a general format dump is shown in 
Figure 27. 

The IMDPRDMP program also reverts to the 
general format if it is unable to format 
control block information because it 
encountered either a control block error or 
one of several user control statement 
format errors. 

Each page of an IMDPRDMP program dump 
listing containing information displayed in 
the general format is identified by a 
heading line. This heading line shows the 
optional title supplied by the user 
followed by the date and time that the 
information was taken from the dumped 
system. A sequential page number also 
appears in each heading line. 

Listings being produced under control of 
the PRINT ALL, PRINT CURRENT, or PRINT 
STORAGE (no operands) format control 
statement display the contents of the 



sixteen general purpose registers. If the 
dump was obtained from a multiprocessing 
system and both sets of registers were 
obtained, then the contents of both sets of 
registers are displayed. Where applicable, 
the beginning of each main storage region 
is noted by a line that gives the job, step 
and procedure step name of the owning task, 
followed by the status of the region 
(BORROWED, ROLL-OUT, OWNED). 



Then, starting at an address requested 
by the user, as specified in a PRINT user 
control statement, (or location zero if no 
address was specified) the contents of main 
storage are displayed*. Each line of the 
general format displays eight words of main 
storage. Preceding each line of 
information is the address of the first 
byte displayed followed by a one-character 
storage protection key indicator 
representing the key associated with the 
area of main storage being displayed on 
this line. Following each line of 
information, a 32-character translation 
field is printed. This field gives the 
EBCDIC translation of the translatable 
characters in the eight hexadecimal words. 
Untranslatable bytes are represented by 
positional periods. 

Printing of any line that duplicates the 
contents of the line printed previously, is 
suppressed. Duplicate lines are indicated 
by the phrase "TO NEXT LINE ADDRESS SAME AS 
ABOVE" following the line duplicated. 
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MODULE IH05A0MP OATE ll/l2/70 TIME 00.15 °AGE 0001 



R 0-7 
R 3-15 

000000 
000020 
C00040 
000060 
000030 
0300A0 
C000C0 
OOOOEO 
0C01OO 
000120 
000160 
000180 
0001A0 
0001C0 
C301EO 
C00200 
000220 
CO 0240 
C00260 
000280 
C002A0 
0002CO 
0002E0 
C00300 
000320 
000340 
000360 
000380 
0003A0 
C003CO 
C003E0 
000400 
C00420 
000440 
300460 
000480 
0004A0 
0004C0 
0004E0 
000500 
000520 
000540 
000560 
000580 
0005A0 
OO05C0 
0005E0 
000600 
000620 
000640 
000660 
000680 
0006A0 
0006C0 



OOOOOCOO 
00000000 
00000191 
FFC40C01 
000022E8 
982400C8 
310000A6 
00000000 
020000C8 
40404040 
61F0F161 
00000000 
000 00000 
FF060C09 
00009A00 
000117E0 
OOOOOOCC 
00072600 
00004E98 
5834002C 
30104770 
302291FF 
00041BAA 
5C84927F 
071C1812 
91011001 
OF9C1000 
47500E2A 
4BA0508C 
91102000 
4770065C 
91082000 
066447F0 
040694E7 
50007031 
91082001 
47100402 
05017035 
9D006000 
00444780 
4BC05096 
20119101 
91027013 
001C58FF 
41E000A2 
06249602 
05AE9101 
050658A2 
41C00664 
94DP2000 
507407FB 
600005A0 
04A005CC 
509A45E0 
20090041 
70069120 



000022C8 
00000000 
C0001C00 
5000BBB2 
OCOOOOOO 
9D001000 
4CC0C005 
00000000 
2C000048 
40404040 
F9F94040 
OCOOOOOO 
00000000 
80COO0OO 
00009AF4 
00009BB4 
000729CO 
00067594 
OOOOOOOO 
05022015 
02724873 
700247E0 
43A7C00A 
2004501B 
58E00FC8 
47100352 
40105068 
91107C06 
50A0C024 
471003E6 
58AC7030 
4780030A 
06249104 
20019110 
91012000 
471C0490 
D5017031 
A00C47C0 
47BC04A0 
8008945F 
41AC7031 
200C4780 
47800530 
000005EF 
94FE7C06 
70064060 
70064780 
00189101 
41B00624 
58F3001C 
92000048 
88A00018 
4770068E 
075207F8 
471006E4 
00444710 



OOOOOOOO 
OOOOOOOO 
40002 0B4 
FFF50C04 
00002280 
0002 0000 
C8C00080 
00000450 
C2C5D5C4 
40404040 
40404040 
OOOOOOOO 
OOOOOOOO 
C000018A 
00009968 
C0000040 
OOOOOOOO 
0006 5D40 
41500800 
30194770 
00229170 
0ED491A0 
89A00003 
000094F0 
07FE4180 
4C710002 
18A09200 
47100DE6 
18B09620 
41A05020 
91042C01 
50A050JO 
20014780 
20014710 
47100432 
C5037033 
A00*4770 
049002 01 
48A00044 
700691AO 
40AOC002 
051CD202 
58A00048 
47F005 5C 
94DF2000 
70044010 
0DD247F0 
20004710 
50A00048 
58FF0004 
91017006 
42A20010 
96A07006 
D2C37031 
18E096A0 
30C49608 



8000214A 
OOOOOOOO 
6000002B 
A006E7C2 
00005E08 
00000003 
40000001 
00D20650 
40404040 
404040C6 
40404040 
OOOOOOOO 
82000170 
018A018A 
000099B4 
00009B74 
0006F000 
00072798 
1A551821 
OE0491FO 
70124780 
50984790 
41DA52FC 
50984580 
02D245C0 
902310C4 
1008A023 
48AD0006 
B02092F0 
0200AOOO 
471O03C0 
92085030 
05D647F0 
05709102 
02077030 
A0064740 
053E9104 
7035A008 
54A05058 
50984790 
43B07030 
C0112019 
47F005E0 
47F00554 
47F00752 
701447F0 
040E9407 
050258A2 
91202000 
50B05074 
47800638 
58900FC0 
43907004 
50004720 
70069106 
70069140 



00002280 
OOOOOCOO 
08000080 
OOOOFFOO 
5A643360 
9D001000 
05001C00 
445000B8 
40404040 
F0F8C107 
OOOOOOOO 
OOOOOOOO 
00040000 
FF000190 
00009AP0 
5000BCA4 
5006E596 
4006E7AE 
92825098 
00214780 
02824393 
029E58F0 
07FC4012 
02F647F0 
02A247F0 
5001000C 
45E00A00 
07FAD502 
09771B99 
302045C0 
58A2001O 
41A05028 
03889140 
70064710 
20201BAA 
053ED503 
30084780 
41A05038 
477C06A8 
800818B6 
89B00004 
91082001 
45C0062* 
47F00432 
58C20018 
04CA4910 
702C94DF 
001047FO 
47800604 
05EF47FO 
91102001 
05B91B99 
1A994079 
070C58A0 
00454770 
004407 IE 



OOOOOOOA 
OOOOOOOO 
40000001 
OOOOOOOO 
48100002 
47700070 
40000500 
47F0006C 
40404040 
09F7F040 
OOOOOOOO 
OOOOOOOO 
00036018 
FF000190 
80009B74 
6000A57A 
000729B8 
0001828C 
18114010 
025A45E0 
001C43A2 
0FC445EF 
001ED708 
02E247F0 
03444810 
92001004 
91EF7006 
20150FD1 
58A00FBC 
05E407BC 
91012000 
0200502D 
702C4710 
04D241A0 
43A70030 
7033A00A 
0490D501 
41B00578 
96A27006 
88B00008 
439B3020 
4780051C 
077C96A6 
41E00960 
47F0051C 
702A4770 
200047F0 
05EOD200 
910C402C 
061E41E0 
4710063E 
40607004 
52F00600 
004841AO 
0F8C9110 
91840044 



OOOOOOOO 
OOOOOOOO 
FFE50000 
FF060009 
412 000C0 
91030044 
06001C00 
D2002000 
40404040 
F0F04BF1 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
00000001 
00009ADO 
00000030 
A006E740 
OOOOOOOO 
50881804 
0E681B99 
002 089AO 
000041C0 
20082008 
02EA4700 
0F9C1211 
D300100C 
^7708008 
47800308 
5090AOOO 
48A00044 
4780O3C0 
70185OA0 
C5929101 
703140A0 
69A00004 
4720053E 
7035A008 
45C005E8 
D2062009 
89B00002 
4290C00D 
9618C00D 
700647F0 
47F00564 
05037031 
CD069148 
C40E9110 
50082018 
47800624 
096447F0 
03000048 
40107014 
700C5O9A 
A00850AO 
00444780 
47808008 



OOOOOOOO 
400020B4 
900432B6 
80000000 
50200048 
4750007C 
000004B0 
OOD84-040 
40404040 
F140F1F4 
OOOOOOOO 
OOOOOOOO 
OOOOOOOO 
FPFF6528 
4000B362 
0006F9F4 
0C000001 
OOOOOOOO 
58420014 
18A991FE 
9000437A 
02B253B2 
04032000 
00 0045EO 
4740035C 
0021D201 
91 C FC»=B0 
58A0C024 
47FC02E2 
54A05058 
58A20018 
004841CO 
70064770 
50 3A0203 
41AA3020 
91027013 
4740048A 
47700688 
00419104 
48CB52D4 
D202C311 
50C00048 
066C58F3 
92422004 
50004770 
702C4710 
20004710 
41A05008 
943F402C 
075258B0 
1C0C9C00 
58A02010 
D7C0700C 
0040D206 
0714945F 
41808004 
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Figure 27. Sample of General Format Dump 
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OUTPUT COMMENTS 

The following output comments are printed 
within the body of a formatted dump 
whenever IMDPRDMP is unable to locate, 
format and print a control block- These 
comments explain why the referenced control 
block is not printed within the dump 
listing, these output comments are 
separated from the main storage information 
by a blank line both before and after each 
output comment. Note: Output Comments 
produced when IMDPRDMP is processing GTF 
output are shown in Section 3 of this 
publication under the heading •IMDPRDMP 
Output Comments - GTF Processing*. 



DUPLICATE PREFIX FOLLOWS 



ID *A' 



Explanation : While processing a 
dump from a Model 65 
multiprocessing system, IMDPRDMP 
has determined that the CPU 
prefixes (CPUIDs) are the same. 
If the task that performs the dump 
is initiated on one CPU, 
interrupted, dispatched to the 
second CPU, and completed the rest 
of the processing on the second 
CPU, then the prefix shown in this 
output comment is that of the 
first CPU to which the task was 
assigned. Processing continues. 

END OF FILE ON DUMP TAPE 

Explanation : While trying to 
locate a block of main storage on 
the dump tape, IMDPRDMP reached 
the end of the tape. This message 
is printed only if IMDPRDMP is 
either trying to extract the CVT 
pointer or trying to extract an 
area of storage for printing. 

Processing terminates. If 
IMDPRDMP did no formatting and the 
tape does not contain a low-speed 
dump produced by IMDSADMP, the job 
may be rerun using the CVT control 
statement to direct IMDPRDMP to 
the CVT in this dump. Low-speed 
dumps produced by IMDSADMP can not 
be formatted by IMDPRDMP. 

ERROR FINDING PARTITION BOUNDARIES FOR TCB 
aaaaaa 

Explanation : IMDPRDMP found (1) a 
TCB family chain pointer, (2) a 
partition boundary box pointer, or 
(3) a pointer within the partition 
boundary box that was one of the 
following: 

1. Addressed an area that was 
not on a full-word boundary. 

2. Addressed an area that was 



higher than the highest 
address in the dump. 
3. Could not be extracted from 
the dump because either an 
I/O error was encountered 
while attempting to read the 
block containing the pointer 
or the block containing the 
pointer was missing from the 
dump. A possible cause for a 
missing block is that the 
routine that produced the 
dump encountered an I/O error 
while attempting to write the 
block. 
Processing continues. 

ERROR FINDING REGION BOUNDARIES FOR 
TCB aaaaaa. 

Explanation : While attempting to 
determine the region boundaries 
for the family of TCBs attached to 
the job step TCB at address 
aaaaaa, one of the following 
conditions occurred: 

• IMDPRDMP found a chain with 
more than fifty partition 
queue elements (PQEs) ; or, 

• IMDPRDMP found (1), a TCB 
family chain pointer, (2) a 
partition queue element CPQE) 
pointer (TCB + x^ 1 ), or (3) 
a pointer within a PQE that: 

1. Addressed an area that was 
not on a word boundary; 
or, 

2. Addressed an area that was 
higher than the highest 
address in the dump; or, 

3. Could not be extracted 
from the dump decause 
either an I/O error was 
encountered while 
attempting to read the 
block containing the 
pointer or the block 
containing the pointer was 
missing from the dump; a 
possible cause for a 
missing block is that the 
routine that produced the 
dump encountered an I/O 
error while attempting to 
write the block. 

Processing continues. 

ERROR FORMATTING TCB 

Explanation : One of the fields in 
the TCB required for formatting 
could not be extracted from the 
dump because: 

• IMDPRDMP encountered an I/O 
error while attempting to read 
the block that contains the 
required data; or. 
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• The block containing the 

required data was missing from 
the dump; a possible cause is 
that the routine that produced 
the dump encountered an I/O 
error while attemtping to 
write the block. 
Processing continues - 



ERROR IN DEB CHAIN 

Explanation ; The routine that 
formats the data extent block 
(DEB) found one of the following 
errors : 

• A DEB chain pointer: 

1. Was not on a word 
boundary; or, 

2. Addressed an area of main 
storage higher than the 
highest address in the 
dump; or, 

• The address of the DEB was 
invalid causing the address of 
the DEB prefix (DEB - 16) to 
be zero or negative; or, 

• A DEB chain pointer or one of 
the fields necessary to format 
the DEB could not be extracted 
from the dump because: 

1. IMDPRDMP encountered an 
I/O error attempting to 
read the block that 
contained the data; or, 

2. The block containing the 
data was missing from the 
dump; a possible cause is 
that the routine that 
produced the dump 
encountered an I/O error 
while attempting to write 
the block. 

Processing continues. 

ERROR IN EXTENT LIST 

Explanation : While formatting the 
load list or job pack area of an 
MVT dump, IMDPRDMP encountered a 
contents directory entry (CDE) 
that had a block extent list with 
a relocation factor (extent list + 
1) of zero or greater than 
twenty-five. A relocation factor 
of zero is an error; however, a 
value greater than twenty- five can 
be valid. The value of 
twenty-five was established by 
IMDPRDMP as a reasonable limit; it 
is improbable that a normal task 
would have a program that has more 
than twenty-five CSECTs causing it 
to get an extent list with a 
relocation factor greater than 
twenty- five. Processing continues 
with the next CDE. 
ERROR IN JOB PACK QUEUE 



Explanation : The routine that 
formats the job pack area 
encountered one of the following 
errors: 



A job pack queue chain pointer 
addressed an area that: 

1. Was not on a word 
boundary, or, 

2. Was greater than the 
highest address in the 
dump. 



• A job pack queue chain pointer 
or one of the fields in a job 
pack area control block could 
not be extracted from the dump 
because: 

1. IMDPRDMP encountered an 
I/O error attempting to 
read the block containing 
the needed data, or, 

2. The block containing the 
needed data was missing 
from the dump; a possible 
cause is that the routine 
that produced the dump 
encountered an I/O error 
while attempting to write 
the block. 

Processing continues. 



ERROR IN LOAD LIST 



Explanation : The load list print 
routine encountered one of the 
following errors: 

• A pointer in the load list 
control block chain referenced 
an area of main storage that: 

1. Was not on a word 
boundary, or 

2. Was greater than the 
highest address in the 
dump. 

• A field in a load list queue 
control block could not be 
extracted from the dump 
because: 

1. IMDPRDMP encountered an 
I/O error attempting to 
read the block that 
contained the data needed 
to format the load list; 
or, 

2. The block containing the 
data was missing from the 
dump; a possible cause is 
that the routine that 
produced the dump 
encountered an I/O error 
while attempting to write 
the block. 

Processing continues. 
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ERROR IN TCB CHAIN DURING PRINT ALL 
FUNCTION 



ERROR IN TIOT 



the dump. 



Explanation : The PRINT ALL 
routine encountered a TCB chain 
pointer that was not on a 
full-word boundary or addressed an 
area that could not be extracted 
from the dump decause: 

1. The pointer addressed an area 
higher than the highest 
address in th dump. 

2- IMDPRDMP encountered an I/O 
error while trying to read 
the record that contained the 
area addressed by the 
pointer. 

3. The record containing the 
addressed area was missing 
from the dump, possibly 
because the routine that 
produced the dump encountered 
an I/O error while attempting 
to write the record. 
No more TCBs are processed, but 
all tasks encountered up to the 
point are printed. The last TCB 
printed may contain the error 
described in 1 above or point to 
the unavailable area described in 
2 and 3 above. 



Explanation : The format routine 
found one of the following errors 



The task input output table 
(TIOT) pointer (TCB ■► X'C) 
was not on a word boundary; 
or. 



One of the fields required to 
format the TIOT could not be 
extracted from the dump 
because: 



IMDPRDMP encountered an 
I/O error while attempting 
to read the block that 
contains the required 
data, or. 



2. The block containing the 
required data was missing 
from the dump; a possible 
cause is that the routine 
that produced the dump 
encountered an I/O error 
while attempting to write 
the block. 



ERROR IN TCB CHAIN TCB aaaaaa 

Explanation : The routine that 
formats the TCBs encountered one 
of the errors given below; the 
address of the TCB associated with 
the error replaces the aaaaaa 
field of the output comment. 

• A TCB pointer for one of the 
TCBs in the TCB family chain 
addressed an area not on a 
word boundary; or, 

• A TCB pointer or the TIOT 
pointer in the TCB at location 
aaaaaa points to an area that 
could not be extracted from 
the dump because: 

1. IMDPRDMP encountered an 
I/O error while attempting 
to read the block that 
contains the pointer; or, 

2. The routine that produced 
the dump encountered an 
I/O error while writing 
the block that contains 
the pointer; therefore, 
the block is missing from 



ERROR WHILE FORMATTING CONTROL BLOCKS 
CONTINUING 



Explanation : While building a 
list of job step TCB*s for all 
partition regions in the dump data 
set, PRDMP encountered one of the 
following conditions: 



1. One of the TCB chain pointers 
was greater than the highest 
address in the dump. 



2. One of the TCB chain pointers 
addressed an area that was 
missing from the dump data 
set. 



PRDMP will attempt to use the 
partial list and continue with its 
formatting. 
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ERROR WHILE FORMATTING PSCB 

Explanation ; One of the following 
errors occurred while IMDPRDMP was 
formatting the protected step 
control block (PSCB): 

• The address of the PSCB in the 
time sharing job block 
extension (TJBX) was greater 
than the highest main storage 
address in dump; or, 

• An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or, 

• A block of dump information 
containing part of the PSCB 
was not found on either the 
dump or swap data sets. 

Processing continues. IMDPRDMP 
attempts to format the control 
blocks for the next TSO user . 



communication vector table 
(TSCVT) was greater than the 
highest main storage address 
in the dump; or, 



An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or. 



• A block of dump information 
containing part of an RCB was 
not found on the dump data 
set. This happens when an I/O 
error occurred while the dump 
routine was writing the data 
onto the dump data set. 
Processing continues. IMDPRDMP 
attempts to format the next entry 
in the RCB table. 



ERROR WHILE FORMATTING SWAP CONTROL BLOCK 



ERROR WHILE FORMATTING RCB 

Explanation : One of the following 
errors occurred while IMDPRDMP was 
formatting the time sharing region 
control blocks (RCBs) : 



The address of the RCB table 
in the time sharing 



Explanation : One of the following 
errors occurred while IMDPRDMP was 
formatting the swap control block 
(SWAP DCB): 

• The address of the SWAP DCB in 
the time sharing communication 
vector table (TSCVT) was 
greater than the highest main 
storage address in the dump; 
or. 
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An I/O error occurred while 
reading the block of dump 
information that contained the 
data; or, 

A block of dump information 
containing part of the SWAP 
DCB was not found on the dump 
data set- This happens when 
an I/O error occurred while 
the dump routine was writing 
the data onto the dump data 
set. 



• A block of dump information 
containing part of the TJB was 
not found on the dump data 
set. This happens when an I/O 
error occurred while the dump 
routine was writing the data 
onto the dump data set. 

Processing continues. IMDPRDMP 
attempts to format the next active 
TJB. 

ERROR WHILE FORMATTING TJBX 



Processing continues. IMDPRDMP 
attempts to continue formatting 
the time sharing job block (TJB). 

ERROR WHILE FORMATTING TAXE 

Explanation : One of the following 
errors occurred while IMDPRDMP was 
formatting the terminal attention 
exit element (TAXE) : 

• The address of the TAXE in the 
time sharing job block 
extension (TJBX) was not 
aligned in a fullword 
boundary; or, 

• The address of the TAXE in the 
TJBX was greater than the 
highest main storage address 
in the dump; or, 

• An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or, 

• A block of dump information 
containing part of the TJBX 
was not found on the dump or 
swap data sets. 

Processing continues. IMDPRDMP 
attempts to format the control 
blocks for the next TSO user. 

ERROR WHILE FORMATTING TJB 

Explanation : One of the following 
errors occurred while IMDPRDMP was 
formatting the time sharing job 
block (TJB) : 

• The address of the TJB table 
in the time sharing 
communication vector table 
(TSCVT) was greater than the 
highest main storage address 
in the dump; or, 

• An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or. 



Explanation : One of the following 
errors occurred while formatting 
the time sharing job block 
extension (TJBX) : 

• The terminal job block (TJB), 
that contained the address of 
the TJB was not aligned on a 
fullword boundary; or, 

• The address of the TJBX in the 
TJB was greater than the 
highest address in the system 
dump; or, 

• An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or, 

• A block of dump information 
containing part of the TJBX 
was not found on either the 
dump or swap data sets. 

Processing continues. IMDPRDMP 
attempts to format the control 
blocks associated with the next 
TSO user. 

ERROR WHILE FORMATTING TSB 

Explanation : One of the following 
errors occurred while IMDPRDMP was 
formatting the terminal status 
block (TSB) : 

• The address of the TSB table 
in the time sharing 
communication vector table 
(TSCVT) was greater than the 
highest main storage address 
in the dump; or, 

• An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or, 

• A block of dump information 
containing part of the TSB was 
not found on the dump data 
set. This happens when a I/O 
error occurred whxle the dump 
routine was writing the data 
onto the dump data set. 
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Processing continues. IMDPRDMP 
attempts to format the associated 
time sharing job block extension 
(TJBX). 



Processing continues- IMDPRDMP 
attempts to continue formatting 
with the terminal status block 

(TSB), 



ERROR WHILE FORMATTING TSCVT 



FORMAT ERROR DURING TCB SUMMARY 



Explanation : One of the following 
errors occurred while IMDPRDMP was 
formatting the time sharing 
communication vector table 
(TSCVT) : 

• The address of the TSCVT in 
the communication vector table 
(CVT) was greater than the 
highest main storage address 
in the dump; or, 

• An I/O error occurred while 
reading the block of dump 
information that contained the 
needed data; or, 

• A block of the dump 
information containing part of 
the TSCVT was not found on the 
dump data set. This happens 
when a I/O error occurred 
while the dump routine was 
writing the data onto the dump 
data set. 

Processing continues. IMDPRDMP 
attempts to format the time 
sharing region control blocks 
(RCBs). 

ERROR WHILE FORMATTING USER MAIN STORAGE 
MAP 

Explanation ; One of the following 
errors occurred while IMDPRDMP was 
formatting the user main storage 
map (UMSM) : 

• The address of the UMSM 
associated with the region 
control task (RCT) or time 
sharing job block (TJB) was 
greater than the highest main 
storage address in the dump; 
or, 

• An I/O error occurred while 
reading the block of dump 
information that contained 
needed data; or, 

• A block of dump information 
containing part of the UMSM 
was not found in the dump data 
set. This happens when an I/O 
error occurred while the dump 
routine was writing the data 
onto the dump data set. 



Explanation ; The routine that 
prints the TCB summary must 
extract a TCB completion code (TCB 
♦ X'W) or a TCB family chain 
pointer from the dump. In this 
case, IMDPRDMP was unable to do so 
because: 

• IMDPRDMP encountered an I/O 
error while attempting to read 
the block containing the 
completion code or pointer; 
or, 

• The block containing the 
completion code or pointer was 
missing from the dump; a 
possible cause is that the 
routine that produced the dump 
encountered an I/O error while 
attempting to write the block. 

Processing for the current control 
statement is terminated. 

FORMAT ERROR IN MAIN STORAGE BLOCKS 

Explanation : While formatting 
main storage control blocks, 
IMDPRDMP encountered one of the 
following errors: 

• A pointer in a main storage 
control block addressed an 
area that: 

1. Was not on a word 
boundary; or, 

2. Was higher than the 
maximum address in the 
dump; or, 

• One of the fields in a main 
storage control block could 
not be extracted from the dump 
because : 

1. IMDPRDMP encountered an 
I/O error while attempting 
to read the block that 
contains the required 
field; or, 

2. The block containing the 
required field is missing 
from the dump; a possible 
cause is that the routine 
that produced the dump 
encountered an I/O error 
while attempting to write 
the block. 

Processing continues. 
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INFINITE LOOP IN DEB CHAIN 



Explanation : While formatting the 
data extent blocks (DEBs), 
IMDPRDMP found more than 200 DEBs 
chained to the TCB. The limit of 
200 DEBs prevents IMDPRDMP from 
looping. When the limit is 
exceeded, a loop is assumed which 
causes this comment to be printed. 
Processing continues after the 
first 200 DEBs are printed. 



INFINITE LOOP IN JOB PACK QUEUE 



Explanation : In MVT, IMDPRDMP 
found more than 255 CDEs on the 
job pack queue associated with the 
TCB. In MFT, IMDPRDMP found more 
than 255 RBs on the job pack queue 
associated with the TCB. A limit 
of 255 job pack queue control 
blocks has been established by 
IMDPRDMP to prevent a possible 
looping condition. When the limit 
is exceeded, a loop is assumed and 
this comment is issued. The first 
255 job pack queue control blocks 
are printed and then processing 
continues . 

INFINITE LOOP IN LOAD LIST 



Explanation : In MVT, IMDPRDMP 
found more than 255 load list 
elements (LLEs) on the load list 
chained to the TCB. In MFT, 
IMDPRDMP found more than 255 RBs 
on the load list. A limit of 255 
elements on the load list has been 
established by IMDPRDMP to prevent 
a possible looping condition. 
When the limit is exceeded, a loop 
is assumed and this comment is 
issued. The first 255 load list 
elements are printed and then 
processing continues. 



INFINITE LOOP IN PQES 

Explanation : The main storage 
print routine found more than 50 
partition queue elements (PQEs) 
chained to the TCB. A limit of 50 
PQEs has been established by 
IMDPRDMP to prevent a possible 
looping condition. When the limit 
is exceeded, a loop is assumed and 
this comment is issued. The first 
50 PQEs are printed and then 
processing continues. 



INFINITE LOOP IN QCB CHAIN 

Explanation : The QCB print 
routine found more than 100 queue 
control blocks (QCBs) on the major 
QCB chain or more than 100 QCBs on 
a minor QCB chain. A limit of 100 
QCBs has been established within 
IMDPRDMP to prevent a possible 
looping condition. When the limit 
is exceeded, a loop is assumed and 
this comment is issued. The first 
100 QCBs are printed and then 
processing continues. 

INFINIT LOOP IN QEL CHAIN 



Explanation : The QCB print 
routine found more than 100 queue 
elements (QELs) on a QEL chain. A 
limit of 100 QELs has been 
established within IMDPRDMP to 
prevent a possible looping 
condition. When the limit is 
exceeded, a loop is assumed and 
this comment is issued. The first 
100 QELs are printed and then 
processing continues. 

INFINITE LOOP IN RB CHAIN 

Explanation : The RB print routine 
found more than 50 request blocks 
(RBs) on the RB chain. A limit of 
50 RBs has been established within 
IMDPRDMP to prevent a possible 
looping condition. When the limit 
is exceeded, a loop is assumed and 
this comment is issued. The first 
50 RBs are printed and then 
processing continues. 

INFINITE LOOP IN TIOT 

Explanation : While formatting the 
TIOT, IMDPRDMP found more than 255 
DD entries in the TIOT. Since 
only 255 DD statements are allowed 
per job step, a valid TIOT cannot 
have more than 255 DD entries. A 
loop is assumed because the limit 
was exceeded and the TIOT end 
indicator could not be found. 
Processing continues. 



INVALID TIOT 

Explanation : While formatting the 
task input output table (TIOT) , 
the FORMAT routine found an 
invalid job name in the TIOT. To 
be valid, the first character of 
the job name must be A through Z, 
or $, #, a or a blank (X , 40 , >- 
Processing continues. 
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NO ELEMENTS ON LOAD LIST 



Explanation ; The load list 
pointer in the TCB (displacement 
X*24») is zero. The zero pointer 
indicates that (1) no programs 
were loaded by the LOAD macro 
instruction or (2) the load list 
pointer was overlaid with zero. 
Processing continues. 



partition information block (PIB) 
field (TCB + X 9 1C) or the job 
pack queue pointer (PIB ♦ X'24*) 
is zero. PCP does not have a job 
pack pointer; therefore, this 
comment does not appear in a PCP 
dump. A zero job pack queue 
pointer is usually a normal 
condition, especially for a system 
task. Processing continues. 



NO EXTENT LIST 



RB FORMAT ERROR 



Explanation ; While formatting the 
load list and job pack queue for 
an MVT dump, IMDPRDMP encountered 
zeros in the extent list pointer 
(CDE ♦ ' 20*) in a major contents 
directory entry (CDE). This zero 
pointer usually indicates an error 
condition in which the extent list 
pointer was overlaid with zeros. 
Processing continues with the next 
CDE. 



NO LINK PACK AREA QUEUE 



Explanation : In MFT, an LPAMAP 
was requested but the link pack 
area queue pointer (CVT + X'BC*) 
was zero. Processing continues. 



NO MAJOR QCBS 



NO 



RSVC 
RAM 



Explanation ; The QCB TRACE 
routine found zeros as the pointer 
to the first major queue control 
block (QCB). This indicates that 
no resources have been enqueued at 
the time of the dump or that the 
pointer to the QCB queue has been 
overlaid with zeros. Processing 
continues. 

MODULES IN LPA 



Explanation ; In MVT, either the 
CDE or LLE chain, pointing to the 
modules in the link pack area, was 
empty. RSVC modules are found by 
following the LLE pointer in the 
master scheduler TCB (TCBLLEP) . 
Rpocessing continues. 

RAM modules are found by 
following the CDE chain from the 
CVT (CVTQLPAQ). Processing for 
this IMDPRDMP verb ends. 



NOTHING IN JOB PACK 



Explanation ; In MVT, the job pack 
queue field of the TCB (TCB + 
X^C*) is zero. In MPT, the 



Explanation ; While formatting a 
request block (RB), the RB print 
routine found that the request 
block (RB) chain pointer addressed 
an area of main storage that: 

• Was not on a word boundary; 
or, 

• Was higher than the highest 
address in main storage; or, 

• Could not be extracted from 
the dump because: 

1. IMDPRDMP encountered a I/O 
error while attempting to 
read the block that 
contained the pointer; or, 

2. The block that contained 
the pointer was missing 
from the dump. One 
possible cause for this is 
that the program that 
produced the dump may have 
encountered an I/O error 
while writing the block. 

• A field in the RB, or a 
contents directory entry (CDE) 
associated with the RB, 
necessary to formatting the RB 
could not be extracted from 
the dump. Either IMDPRDMP 
encountered an I/O error while 
trying to read the block, or 
the block that contained the 
pointer is missing from the 
dump. 

REGISTERS FROM OTHER CPU ARE INVALID- NOT 
FORMATTED 

Explanation : Multiprocessing 
systems only. Only the registers 
for the CPU in which the dump 
program was executed will be 
displayed on the dump listing. 
This can occur when the dump is 
taken on a multiprocessing system 
either when the NOMP option of 
IMDSADMP is used or when the 
direct control feature is not 
operational. 
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TASK HAS NO OPEN DATA SETS 



Explanation : IMDPRDMP found the 
data extent block (DEB) pointer in 
the TCB (TCB ♦ X* 8') to be zero. 
This situation indicates that 
there were actually no open data 
sets or the DEB pointer in the TCB 
was overlaid with zeros. 
Processing continues. 



TASK HAS NO TIOT 



Explanation : While attempting to 
format the task input output table 
(TIOT) , IMDPRDMP found that the 
TIOT pointer (TCB + T* C* ) was 
either zero or larger than the 
highest address in the dump. The 
zero TIOT pointer could be a 
normal condition for a system 
communication task, but for a 
problem program task this i3 an 
error condition. Processing 
continutes. 

TASK HAS TERMINATED 

Explanation : After formatting a 
TCB, this comment is printed below 
the TCB if the first bit (the 
terminated bit) of the flag byte 
at X'21* of the TCB is set. 
Processing continues with the next 
TCB. 

TCB CHAIN ERROR IN F03 PRINT ROUTINE 
TCB aaaaaa CONTINUING WITH NEXT TCB 

Explanation : The Print F03 
routine encountered a TCB chain 
pointer that: 

• Was not on a word boundary; 
or, 

• Addressed an area that could 
not be extracted from the dump 
because: 

1. The pointer addressed an 
area higher than the 
maximum address in the 
dump; or. 



2. IMDPRDMP encountered an 
I/O error trying to read 
the record containing the 
area addressed by the 
pointer; or, 

3. The block containing the 
addressed area was missing 
from the dump, probably 
because the routine that 
produced the dump 
encountered an I/O error 
while attempting to write 
the block. 

The address of the TCB associated 
with the error replaces the aaaaaa 
field in the message. Processing 
continues with the next TCB. 



UNABLE TO OBTAIN JOB STEP TCB FOR CURRENT 
TASK 



Explanation : In an MFT system 
with ATTACH, the job step TCB is 
used to get the partition 
boundaries. If the address of 
this TCB is zero in the cu rrent 
TCB, then the above comment is 
issued. Processing continues. 



xxxxxx THROUGH xxxxxx COULD NOT BE PRINTED 



Explanation : The block(s) of 
storage between the two addresses 
could not be printed because 
IMDPRDMP encountered an I/O error 
while attempting to read the 
block (s) or the block (s) that were 
missing from the dump. Processing 
continues. 
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Guide to Storage Dumps 



The purpose of this section is to suggest 
debugging procedures that you may use with 
a storage dump. This discussion applies to 
the output of the following programs: 

• IMDSADMP- The low speed version that 
creates an unformatted dump of main 
storage. 

• IMDPRDMP- Reads, formats, and prints 
storage dumps from MFT or MVT systems 
and the high speed version of IMDSADMP. 

These programs produce hexadecimal dumps of 
the contents of main storage from location 
zero to the highest machine address. 

The IMDPRDMP program provides formatting 
capabilities which can be used to display 
the important system control blocks for 
easy examination. The IMDPRDMP program 
does most of the procedures described in 
this section automatically. The cases in 
which the IMDPRDMP program does not provide 
formatting are identified. A complete 
description of the services provided by the 
IMDPRDMP program is found in the 
publication, IBM System/360 Operating 
System: Service Aids . GC28-6719. 

Since the formatting for the IMDPRDMP 
program depends on the contents of the 
dump, it is not always possible to provide 
complete formatting. For example, if the 
CVT of the system to be dumped has been 
overlaid, the IMDPRDMP program can provide 
only a hexadecimal dump of main storage. 
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DETERMINING THE CAUSE OF THE DUMP 

Main storage dumps are invoke by system 
routines and these routines can be 
identified by module names appearing in the 
most recent request block (RB) for the 
failing task. The main storage dump is 
invoked by SVC 51. This SVC PSW appears as 
the resume PSW in the second most recent RB 
of some task in the system. The module 
name in the current RB for that task must 
be 20 1C. 

Main storage locations from zero to 128 
(hexadecimal 80) are permanently assigned 
and contain hardware control words. Figure 
28 shows these fields, their location, 
their length, and their purpose. 

r t t 1 

| Address | Length | | 

| Dec Hex J In Bytes j Purpose j 

j. + + .| 

JO j 8 j IPL PSW j 

| f + J 

1 8 3 1 8 | IPL CCW1 | 

|. 1 + | 

{16 10 j 8 JIPL CCW2 | 

| 1 f , 

j 24 18 | 8 | External old PSW | 

| i i I 

| 32 20 j 8 | Supervisor call old PSW | 

i J J I 

| 40 28 | 8 | Program old PSW | 

| 48 30 J 8 | Machine check old PSW { 
j f x , 

| 56 38 | 8 j I/O old PSW | 

! x x , 

1 64 40 j 8 j Channel Status Word j 
j x x , 

j 72 48 j 4 | Channel Address Word j 

| 76 4C | 4 | Unused | 

j. x x ^ 

| 80 50 | 4 | Timer j 

| x x , 

| 84 54 | 4 | Unused j 
j. + + j 

1 88 58 | 8 | External new PSW j 

I x x _, 

j 96 60 | 8 |Supervisor call new PSW | 
|. x + ^ 

j 104 68 j 8 | Program new PSW^ j 
I x x , 

| 112 70 | 8 | Machine check new PSW j 
^ x x ^ 

j 120 78 J 8 | I/O new PSW j 

i j. x 1 

Figure 28. Permanently Assigned Hardware 
Control Words 

Cause of the Dump ; Evaluate the PSWs that 
appear in the formatted section of the dump 
(the first four lines) to find the cause of 



the dump. The PSW has the following 
format: 



Program Statu* Word 



System Mask Key 


AMWP 


Interruption Code 





7 8 11 12 15 16 


31 


ILC 


CC 


Program 
Mask 


Instruction Address 



32 33 34 35 36 



39 40 



63 



Does the instruction address field of 
the old machine check PSW show either 
the value E2 or E02? If so, a hardware 
error has occurred. 

Does the instruction address field of 
the old program check PSW have a value 
other than zero? If so, a program 
check at the instruction preceding that 
address caused the interruption. 



TASK STRUCTURE 

MFT System (Without Subtaskinq) 

There is a TCB associated with each 
partition of main storage there are also 
TCBs for critical system tasks such as the 
master scheduler task and the transient 
area loading task. Figure 28 shows 
location 76 (4C) unused for hardware 
control words. The control program uses 
this word to contain a pointer to the CVT. 
Use this CVT pointer to locate the first 
byte of the CVT, then the CVTIXAVL field 
(offset 124) in the CVT. The address 
contained at CVTIXAVL is a pointer to the 
IOS freelist. At offset U in the IOS 
freelist is a pointer to the first address 
in a list of TCB addresses. You can look 
through this list of TCB addresses, and, 
keeping your system options in mind, find 
the TCBs for each partition. The TCB 
addresses are listed in the following 
order : 

• Transient area loading task. 

• System error task (MFT with 
subtasking) . 

• Multiple console support write-to-log 
task (optional). 

• I/O recovery management support task 
(optional) . 

• Communications task. 

• Master scheduler task. 

• System management facilities task 

(optional) . 

• Partition task. 
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• Partition 1 task. 



• Partition n task. 

Figure 29 shows how to locate the 
partition TCBs in sample output from the 
IMDPRDMP program. 

MFT System (With Subtaskinq) 

For MFT with subtasking (and for MVT) , a 
task may create a subtask. The partition 
TCBs for MFT with subtasking are referred 
to as job step TCBs . The task structure 
for a job step may be reconstructed in a 
main storage dump by using the information 
in Figure 30. 

For MFT with subtasking, the job step 
TCB may be found using the method described 
for MFT without subtasking or by a more 
direct method. CVT offset 245 (F5) 
contains a pointer to the partition job 
step TCB address in this address table. 

To recreate the task structure within 
any partition, simply locate the job step 
TCB, and follow the TCB pointers - as 
explained in the previous section. 



MVT System 

To find the current TCB, look at location 
76 (4C) for a pointer to the CVT. The 
first word of the CVT contains a pointer to 
a double word of TCB addresses, which 
contains pointers to the next TCB to be 
dispatched (first word) and the current TCB 
(second word) . Beginning with the current 
TCB, you can recreate the task structure 
for the job step using the methods in 
Figure 30. 

If the first word of the current TCB 
points to itself, there are no ready tasks 
to be dispatched, and the system has been 
placed in an enabled wait state. This TCB, 
now in control, is called the system wait 
TCB . 

All TCBs in the system are maintained in 
a queue called the CVT ready queue. These 
TCBs are queued according to their 
dispatching priority. The CVTHEAD field, 
offset +160 (A0) in the CVT, contains the 
address of the highest priority TCB in the 
system. Offset +116 (74) in the TCB points 
to the TCB with the next lowest priority. 
Figure 30 shows how to locate all of the 
TCBs in the system. 



Location 4C 




00CB40 
00CB60 
00CB80 
00CBA0 
00CBC0 



00000000 00000000 00000000 00000000 
00000000 000048BO 0O0OCBOA 00012B80 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh 00004864 



00000774 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 



0000078C 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 
hhhhhhhh 



0000AEE8 00O1A288 
hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh 
hhhhhhhh. hhhhhhhh 
hhhhhhhh hhhhhhhh 




008D40 00000000 00000000 0007D2D8 hhhhhhhh 

08D6 hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 

008U80 hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 

00 8DA0 hhhhhhhh 



hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 
hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 



Figure 29. Finding the Partition TCBs in MFT 
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Job Step TCB | 





Job Step TCB 



TCB 


0© 


•( 


3® 





Job Step TCB 



(a) is a job step TCB and (T) is the | 

TCB of the subtask created by (Aj , I 
Offset +136(88) in (a\ points to its 

subtask TCB ( (£) ). Offset +132(84) I 

in the subtask TCB ( (T) ) points back | 

to the job step TCB ( (a) ). I 




(a) is a job step TCB. (II) is the TCB for the first 
subtask created by f AJ . HJ^ is the TCB for the 
second and most recent subtask created by (a) . 
Offset + 136(88) in ^a) points to the TCB of its 
most recently created subtask. Offset +136(84) 
in ^2) points back to the creating task ( (A) ). 
Offset +128(80) in (1£) points to (ij) the next 
most recently created subtask TCB. Offset 
+ 132(84) in n$n points back to the originating 
TCB(Q). 

In each TCB: 
Offset 

+ 128(80) points to the TCB of the next most 
recently created subtask. If none 
exists, this field is zero. 

+ 132(84) points to the TCB of the task that 

created it. If none exists, this field 
is zero. 

+ 136(88) points to the TCB of the most recent 
subtask created by this task. If none 
exists, this field is zero. 



TCB 


®© 


©© 





©Subtask 
TCB 



(a) is the job step TCB. (B,) is the TCB for the first subtask created by (a) . (*£)'* the TCB 
for the second and most recent subtask created by fAJ . Offset +136(88) in (Aj points to 
the TCB of its most recently created subtask. Offset + 132(84) in (££) points to the TCB of the 
creating task. Offset +128 in HM points to the next most recently created subtask TCB. 
Offset +132(84) in (t£)poinb back to the job step TCB ( (a) ). Offset + 136(88) in (jiz) 
points to the TCB of its most recently created subtask ( (C J ). 

(C$\ points to the TCB of its creating task ( \M) and to the TCB of the subtask most 
recently created by (fy . (&\ contains pointers to the TCB of the originating task ( HSg) ) 
and to the TCB of the task most recently created by (62) . (C2) contains only a pointer to 
the TCB of the invoking task ( (63)). 



Figure 30. Finding the TCB 
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Keep in mind that all TCBs in the system 
appear on this queue. Therefore, not only 
does a particular job step TCB appear on 
the ready queue, but all of its subtask 
TCBs also appear. 

You can find the job step TCB associated 
with any TCB by using the TCBJSTCB field of 
the TCB, offset +124 (7C). This field 
contains the address of the job step TCB 
for the TCB you are examining. 

In response to the FORMAT control 
statement, the IMDPRDMP program will do 
most of this work for you. It will 
recreate the task structure, format all 
TCBs in the system, and provide a TCB 
summary. The TCB summary shows the task 
structure. Figure 31 shows a portion of 
the TCB summary information from an MVT 
system. TCBs associated with a particular 
job are grouped together under t!he job name 
and step name. The TCB summary contains 
the TCB address, the completion code, and, 
when applicable, the address of the 
originating TCB and the addresses of 
created TCBs. 



and/or second words of the RB for its 
EBCDIC name or in the last 3 digits of the 
resume PSW in the previous RB for its SVC 
number. The entry point to the module is 
in the last 3 bytes of the fourth word in 
the RB, RB-13CD). 

In an MVT system, the name and entry 
point of the associated load module are not 
always contained in the RB associated with 
the module. Instead, they are found in a 
contents directory entry (CDE) . 

The address of the contents directory 
entry for a particular load module is given 
in the fourth word of the RB, RB+12CC). 
The CDE gives the address of the next entry 
in the directory (bytes 1-3), the name of 
the load module, bytes 8-15(F); the entry 
points of the module, bytes 17-19(11-13). 

Figure 31 shows the formatting that the 
IMDPRDMP program does for a task in an MVT 
system. Notice the connection between the 
RB and the CDE. The IMDPRDMP program 
extracts the CDE information and displays 
this information with the RB. 



TASK STATUS - ACTIVE RB QUEUE 

The first word of the TCB contains a 
one-word pointer to the first word of the 
most recent RB added to the queue. In its 
eighth word, RB+28(lC), each RB contains a 
pointer to the next most recent RB. The 
last RB points back to the TCB. 

You can determine the idenity of the 
load module by looking either in the first 



The wait-count field of the RB is 
particularly important when locating the 
TCB by using the CVT ready queue (CVTHEAD) . 
The high-order byte of the RB link field, 
RB-28(1C), of the most recent RB for a TCB 
contains a count of the number of events 
for which the task is waiting. Tasks that 
have a zero wait count are ready to be 
dispatched (unless marked 
non-dispatchable) . Such a task will be 
dispatched or become the current task when 
all TCBs of higher priority are waiting for 



MASTER STEP SCHEDULER 
TCBhhhhhh CMPhhhhhhhh 

MASTER STEP SCHEDULER 
TCBhhhhhh CMPhhhhhhhh 

WTR STEP 00E 
TCBhhhhhh CMPhhhhhhhh 
TCBhhhhhh CMPhhhhhhhh 

J0B11 STEP GO 
TCBhhhhhh CMPhhhhhhhh 
TCBhhhhhh CMPhhhhhhhh 
TCBhhhhhh CMPhhhhhhhh 

J0B12 STEP GO 
TCBhhhhhh CMPhhhhhhhh 



C B S U M M A 
NTChhhhhhhh 
NTChhhhhhhh 



NTChhhhhhhh 
NTChhhhhhhh 



NTChhhhhhhh 
NTChhhhhhhh 
NTChhhhhhhh 



R Y * * * * 
OTChhhhhhhh 
OTChhhhhhhh 



OTChhhhhhhh 
OTChhhhhhhh 



OTChhhhhhhh 
OTChhhhhhhh 
OTChhhhhhhh 



LTChhhhhhhh PAGE hhhh 
LTChhhhhhhh PACE hhhh 



LTChhhhhhhh PAGE hhhh 
LTChhhhhhhh PAGE hhhh 



LTChhhhhhhh PAGE hhhh 
LTChhhhhhhh PAGE hhhh 
LTChhhhhhhh PAGE hhhh 



NTChhhhhhhh OTChhhhhhhh LTChhhhhhhh PAGE hhhh 




Figure 31. IMDPRDMP TCB Summary 
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the completion of an event. To determine 
the events for which a task is waiting, use 
the instruction address field in the resume 
PSW to locate the WAIT macro instruction in 
the source program. This will point you to 
the operation being executed at the time of 
the dump. 



MAIN STORAGE CONTENTS 

Load List (MFT) 

The load list is a chain of request blocks 
associated with load modules invoked by a 
LOAD macro instruction. By looking at the 
load list, and at the job pack area queue 
described below, you can determine which 
system and problem program routines were 
loaded before the dump was taken. To 
construct the load list associated with the 
task in control, look at the tenth word in 
the TCB, TCB+36C24), for a pointer to the 
most recent RB entry on the load list, 
minus 8 bytes (RB-8). This word, in turn, 
points to the next most recent entry (minus 
8) , and so on. If this is the last RB, 
RB-8 will contain zeroes. The word 
preceding the most recent RB on the list 
(RB-4) points back to the TCB's load list 
pointer. 

Load List (MVT) 

To construct the load list associated with 
the task in control, look at the tenth word 
in the TCB, TCB+36(2«4), for a pointer to 
the most recent load list entry (LLE) . 
Each LLE contains the address of the next 
most recent entry (bytes 0-3), the count 
(byte 4), and the address of the CDE for 
the associated load module (bytes 5-7). If 



this is the last LLE in the list, 
TCB+36(24) will contain zeroes. 

Job Pack Area Queue (MFT With Subtasking. 
MVT) 

In systems with MPT with subtasking or MVT 
control programs, the job pack area queue 
is used to maintain reenterable modules 
within a partition or region. The complete 
description of this queue is found under 
the topic "Task Status- Active RB Queue" . 

MFT System : To reconstruct the job pack 
area queue in an MFT system with 
subtasking, look at TCB+125(7D) for a three 
byte pointer to the partition information 
block (PIB). The twelfth word of the PIB, 
PIB**»4(2C) , points to the most recent RB on 
the job pack area queue minus 8 bytes 
(RB-8). This word in turn points to the 
next most recent RB minus 8, and so on. 
The last RB will have zero in this field. 
The word preceding the most recent RB on 
the queue (RB-4) points back to the job 
pack area queue pointer in the PIB. You 
can determine the identity of the load 
module by looking either in the first 
and/or second word of the RB for its EBCDIC 
name, or in the last three digits of the 
resume PSW in the previous RB for the SVC 
number. The entry point of the module is 
given in the last three bytes of the fourth 
word in the RB, RB+29(1D), unless it is an 
FRB. 

The first five words of an FRB 
(beginning at offset minus 8) are identical 
in content to those of other RBs. The 
XRWTL field, offset 12(C), contains the 
address of a wait list element. The first 
word of the WLE points to the next WLE, or 



ACTIVE RBS 



PRB 02DEB0 RESV hhhhhhhh APSW hhhhhhhh WC-SZ-STAB hhhhhhhh FL-CDE 0002DFD0 PSWFF050001 5006E3.C2 
Q/TTR hhhhhhhh WT-LNK hhhhhhhh NM IEFSD079 EPA 06E038 STA 06CEC0ILN 001940 ATRl 08 





JOB PACK QUEUE 

CDE 02DFD0 NM IEFSD079 USE 01 RESP NA ATRl 08 EPA 06E038 STA 06CEC0 LN 001940 




Module Name 

Figure 32. Determining Module From CDE in MVT 




Entry Point Address 
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contains zeros if the WLE is the last one. 
The second word points to the waiting SVRB. 
You can determine the number of deferred 
requests for the module by tracing the 
chain of WLEs. 

The XRREQ field of an FRB, offset 
16(10), contains a pointer to the TCB of 
the requesting task. The next word, 
CRTLPRB,, offset 20(14), points to an LPRB 
built by the Finch routine for the 
requested program. The FRB for the 
requested program is removed from the job 
pack area queue by the Finch routine when 
the program is fully loaded. 

MVT System ; In MVT, the job pack area 
queue is maintained in the same manner as 
the load list. The distinction between the 
two queues is that the job pack area queue 
contains reenterable programs. There are 
no FRBs in MVT. 



MAIN STORAGE SUPERVISION 

Free Areas in MFT Systems 

Areas of main storage that are available 
for allocation at the time the dump was 
taken are described by the MSS boundary box 
and a series of free queue elements (FQEs). 
The seventh word of the TCB for the task, 
TCB* 24 (18), points to a six- word MSS 
boundary box. The first word of the MSS 
boundary box points to the FQE with the 
highest processor storage address in the 
partition (hierarchy 0), and the fourth 
word, to the highest 2361 Core Storage 
address in the partition (hierarchy 1). 
The first word of each FQE points to the 
next lower FQE; the second word of the FQE 
gives the length of the area it describes. 
FQEs occupy the first 8 bytes of the area 
they describe. 

Gotten Subtask Areas (MFT) 

In MFT with subtasking, areas of a 
partition allocated by the system to a 
subtask within the partition are described 
by gotten subtask area queue elements 
(GQEs). The seventh word of the subtask 
TCB, TCB+24(18), points to a one word 
pointer to the most recently created GQE on 
the GQE queue. Bytes through 3 of the 
GQE contain a pointer to the previous GQE 
or, if zero, indicate that the GQE is the 
last one on the queue. Bytes 4 through 7 
of the GQE contain the length of the gotten 
subtask area. Each GQE occupies the first 
eight bytes of the gotten subtask area it 
describes. 

Region Structure in MVT System 

The region associated with a particular 
task in an MVT system is described by 



partition queue elements (PQEs). The 
thirty-ninth word of the TCB, offset +152 
(98) contains a pointer to the dummy PQE 
(D-PQE) for the region. The first word of 
the dummy PQE points to the first PQE and 
the second word, to the last PQE. The 
first and second words of each PQE point to 
the first and last free block queue 
elements (FBQEs), respectively, associated 
with the PQE. Separate PQEs are used to 
describe parts of a region in different 
storage hierarchies or part of a region 
that was obtained by another task which has 
been rolled out. 

FBQEs describe free areas in the region 
that have a a length which is a multiple of 
2048 bytes. These free areas are available 
for allocation to a specific subpool. 

Subpool Descriptions (SPQEs) (MVT) : The 
seventh word of the TCB, TCB+24(18) , points 
to the SPQE representing the first subpool 
used by the task. Each SPQE contains the 
address of the next SPQE (bytes 1-3), the 
subpool number (byte 4), and the address of 
the first descriptor queue element (DQE) 
for the subpool (bytes 5-7) or, if the 
subpool is owned by another task (bit is 
1) , the address of the SPQE that describes 
it (bytes 5-7). 

Storage within a subpool is described by 
a descriptor queue element. Each DQE 
contains the number of bytes of main 
storage in the subpool. This count is 
always a multiple of 2048 bytes. If a 
request for space from a subpool cannot be 
satisfied with the space described by an 
existing DQE the GETMAIN routine builds 
another DQE and links the new DQE to the 
chain of existing DQE"s. Each DQE contains 
a pointer to the FQE that represents the 
free area with the highest main storage 
address in the subpool (bytes 1-3), a 
pointer to the next DQE (bytes 5-7), and 
the length of the area described by the 
DQE, bytes 13-15 (D-F). 

Figure 33 shows the control blocks used 
to describe the subpools for a task in an 
MVT system. 



I/O CONTROL BLOCKS 

Queue of DEBs 

To find the queue of DEBs for the task, 
look at the third word in the TCB (TCB+8). 
The address given here points to the first 
word of the most recent entry on the DEB 
queue. There is a DEB on this queue for 
each data set opened to the task at the 
time of the dump. DEBs are enqueued in the 
same order as the data sets are opened. 
The last three bytes of the second word in 
each DEB (DEB+5) points to the next most 
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recent DEB on the queue. The queue 
contains one DEB for each open data set. 

UCBs 

You can find unit information for each 
device in your system in the unit control 
block (UCB) for that device. The address 
of the UCB is contained in the last 3 bytes 
of the ninth word of the DEB, DEB+33 (21) . 
If the DEB queue is empty, scan the dump 
around location 4096(1000) for words whose 
fifth and sixth digits are FF. These are 
the first words of the UCBs for the system; 
UCBs are arranged in numerical order by 
device address. (You may find it easier to 
locate UCBs by looking for the device 
address in the EBCDIC printout to the right 
of each page.) The first two bytes of the 
second word of each UCB give the device 
address. The device type and class are 
given in the third and fourth bytes of the 
fifth word, UCB* 18 (12), respectively. The 
sense bytes, with the exception of those 
for devices with extended sense, begin in 
the last two bytes of the sixth UCB word, 
UCB+22(16), and continue from 1 to 6 bytes 
depending on the device type. For the 
extended sense devices, UCB+22 and UCB+23 
are ignored. UCB* 24 (18) in this case 
contains the number of bytes of sense 



information to be found starting at the 
address specified in UCB*25(19). Sense 
bytes are given in Appendix G of this 
publication. 

DCB and TIOT 

The address of the DCB, a control block 
that describes the attributes of an open 
data set, is located in the last 3 bytes of 
the seventh DEB word, DEB+25(19). The 
first two bytes of the ninth word of the 
DCB, offset 40(28), contains the offset in 
the task input/output table (TIOT) of the 
DD name entered for the data set. 
Therefore, the address of the DD name for a 
particular- data set may be found by adding 
the TIOT offset in the DCB to the TIOT 
address in the TCB (TCB+12), plus 24(16) 
bytes for the TIOT header. 

IQB 

If a data set is being accessed by a 
sequential access method with normal 
scheduling, the address of the input/output 
block (IOB) prefix (IOB-8) is located in 
the seventeenth word of the DCB, 
DCB-68(44). The first word of the IOB 
prefix points to the next IOB (if more than 
one IOB exits for the data set) . Each IOB 
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Figure 34. I/O Control Blocks 



for an open data set contains a pointer to 
the CCW list in the last three bytes of the 
fifth word, IOB+17(ll). 



ECB 



The Completion code for an I/O operation is 
posted in the first byte of the event 
control block (ECB). ECB completion codes 
are explained in Appendix F. 1Ef the I/O 
event is not complete and an SVC I (WAIT) 
has been issued, the high- order bit of the 
ECB is on, and bytes one through three 
contain the address of the associated RB. 
For the sequential and basic partition 
access methods the second word of an IOB 
points to its associated ECB. 



Figure 34 shows the DEB, UCB, DCB, and 
IOB for a BSAM data set. 



TSO CONTROL BLOCKS 

The time sharing (TSO) control blocks are 
obtained from the IMDPRDMP service aid 
program by specifying the TSO control 
statement in the input stream. The first 
part of the TSO dump is the same as the 
normal MVT dump. The control blocks that 
IMDPRDMP formats are divided into two 
group: system and user. 



TSCVT 

The time sharing communications vector 
table (TSCVT) is a secondary CVT for the 
MVT CVT. The time sharing CVT resides in 
the time sharing region; therefore, it 
exists only while the time sharing region 
is active. When time sharing does not 
exist in the system, the MVT CVT pointer to 
the TSCVT (CVT+229) is zero. 
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RCB 

A region control block (RCB) contains 
information that is unique to a time 
sharing region. There is one RCB for each 
time sharing region. The RCBs reside in 
the time sharing controller's region, they 
are contiguous, and they are created during 
initialization of the time sharing 
controller. 

The TSCVT points to a region control 
block table. The RCB table is an indexed 
table containing one RCB address for each 
possible time sharing region, therefore, 
the table contains the maximum number of 
RCBs that may be used by time sharing. The 
first RCB is for region one, the second for 
region two, etc. The time sharing job 
block (TJB) of a job points to the RCB 
associated with that job. 

UMSM 

One user main storage map (UMSM) exists for 
each possible time sharing user. The UMSM 
contains a series of consecutive one-word 
extent fields (ADDR-LN) . Each one-word 
extent contains a half word address field 
(ADDR) and a halfword length field (LN) 
that describes the main storage allocated 
to the time sharing user. The UMSM 
contains the address and length of a 
storage block (a multiple of 2K bytes) that 
has been allocated to the user; only this 
allocated storage will be swapped out for 
the user. The time sharing job block (TJB) 
points to the UMSM. 

SWAP DCB 

The swap data control block (SWAP DCB) is 
used whenever a time sharing user's region 
is swapped into or out of main storage. It 
describes a swap data set that contains an 
IOB, area for channel programs, and the 
track map queue. The TJB points to the 
swap DCB. 

TJB 

The time sharing job block (TJB) contains 
status information about a time sharing 
user. The TJB is retained in main storage 
while the user is swapped out. One -time 
sharing job block exists for each possible 
simultaneous time sharing user. The space 
for the TJB is obtained from the time 
sharing control task (TSC) region during 
time sharing initialization. Status 
information about the terminal related to 
this TJB is contained in the terminal 



status block (TSB). The address of the 

terminal status block is the first word of 

the TJB. The first word of the TSCVT 
points to the TJB. 

TSB 

Each terminal status block (TSB) contains 
status information about one terminal. The 
terminal input/output coordinator (TIOC) 
uses this information. During system 
initialization, one TSB is created for each 
possible user. The main storage space is 
obtained in one contiguous block for all of 
the TSBs in the region of the time sharing 
control task (TSC) ; this contiguous string 
of TSBs is called the TSB table. The 
origin pointer to the TSB table is the 
TIOCTSB field of the TIOCRPT. 

TJBX 

The time sharing job block extension (TJBX) 
contains user job information that can be 
rolled out to the swap data set with the 
user's job. The TJBX resides in the local 
system queue space (LSQS) for the region. 
The TJBX location is pointed to by the 
third word of the time sharing job block 
(TJB). The space for the TJBX is obtained 
by the region control task (RCT) during 
initialization. 

PSCB 

The protected step control block (PSCB) 
contains accounting information related to 
a single user. All timing information is 
in software timer units. A software timer 
unit is equal to 26.04166 micro seconds. 
The job step control block ( JSCB) , offset 
268, points to the PSCB. 

TAXE 

The TSO terminal attention exit element 
(TAXE) is a physical addendum to a regular 
24 word interrupt request block (IRB). It 
is used to schedule an attention exit 
resulting from a terminal attention 
interruption. It is created, queued, and 
dequeued by the specify terminal attention 
exit (STAX) macro instruction. The main 
storage space for the TAXE is obtained in 
the local system queue space (LSQS) of the 
terminal user's region. 

For a more detailed description of the 
TSO control blocks formatted by the 
IMDPRDMP program, see the Control Block 
and/or TSO Control Program PLM 
publications. 
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Section 3: Tracing Aids 



Tracing aids available are the save area 
chain, trace option, and Generalized Trace 
Facility (GTF) . This section provides a 
description of each tracing aid, and, for 
GTF, describes its output after processing 
by the IMDPRDMP service aid. 



Save Area Chain 

The save area chain is edited and clearly 
identified in ABEND/SNAP dumps, and can be 
located easily in storage dumps produced by 
system dump facilities or the IMDSADMP 
service aid. 

A save area is a block of 72 bytes 
containing chain pointers and register 
contents. It has the following format: 



1. Save registers 0-12 in bytes 

20-71 (14-3F) of save area 1 when it is 
entered. 



2. Establish a new save area (save area 
2). 

3. Place the contents of register 13 into 
bytes 4-7 of save area 2. 

4. Place the address of save area 2 into 
register 13. 

5. Place the address of save area 2 into 
bytes 8-11 (B) of save area 1. 

At this point, the save areas appear as 
shown in Figure 35. 
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registers 0-12 



16(10) 20(14) 

Bytes 4-7: Pointer to the next higher 

level save area or, if this is 
the highest level save area, 
zeros. 

Bytes 8-11 (B): Pointer to the next lower 
level save area or, if this is 
the lowest level save area, 
unused. 

Bytes 12-15 (C-F): Contents of register 14 
(optional) 

Bytes 16-19(10-13): Contents of register 
15 (optional) 

Bytes 20-7K14-3F) : Contents of registers 
to 12 

The save area for the first or highest 
level load module in a task (save area 1) 
is provided by the control program. The 
address of this area is contained in 
register 13 when the load module is first 
entered. It is the responsibility of the 
highest level module to: 
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Figure 35. Save Area Trace 

If a module requests a lower level 
module, it must perform actions 1 through 4 
to ensure proper restoration of registers 
when it regains control. (Action 5 is not 
required, but must be performed if the dump 
printout of the field is desired.) A 
module that does not request a lower level 
module need only perform the first action. 

ABEND and SNAP dumps include edited 
information from all save areas associated 
with the dumped task under the heading 
"SAVE AREA TRACE". In a stand-alone dump, 
the highest level save area can be located 
through a field of the TCB. Subsequent 
save areas can be located through the save 
area chain. 
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TRACE OPTION 

The tracing routine is an optional feature 
specified during system generation- This 
routine places entries, each of which is 
associated with a certain type of event, 
into a trace table. When the table is 
filled, the routine overlays old entries 
with new entries, beginning at the top of 
the table (the entry having the lowest 
storage address). The contents and size of 
a trace table are highly system-dependent. 

Systems With MET : Trace table entries for 
systems with MFT are 4 words long and 
represent SIO, I/O, SVC and dispatcher 
task- switching interruptions. Figure 36 
shows the word contents of each type of 
entry. 



r T T 1 

j Current Entry | First Entry | Last Entry | 

i j. x J 

4 8 

You can locate the trace table by scanning 
the contents of main storage between 
locations 16,384(4000) and 32,768(8000) for 
trace table entries. Entries are four 
words long and begin at addresses ending 
with zero. To find the table boundaries 
and current entry, scan the table in 
reverse until you reach the trace table 
control block. 

Trace Table Entries in MFT : Trace table 
entries for systems with MFT are 4 words 
long and represent occurrences of SIO, I/O, 
SVC, and task-switching interruptions. 
Figure 39 gives some sample entries and 
their contents. 
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Figure 36. Trace Table Entries (MFT) 

Systems with MVT : The trace table in a 
system with MVT is expanded to include more 
entries and more information in each entry. 
Trace table printouts occur only on SNAP 
dumps and stand-alone dumps. Entries are 
eight words long and represent occurences 
of SIO, external, SVC, program, and I/O 
interruptions, and dispatcher loaded PSWs. 

Figure 37 shows the word contents of 
trace table entries for SNAP dumps and 
stand-alone dumps. Figure 38 shows the 
contents of trace table entries as filled 
by MVT with Model 65 multiprocessing. (SSM 
— set system mask — entries are 
optional.) 



INTERPRETING TRACE TABLE ENTRIES 

Location 84(54) in main storage contains 
the address of the first word of the three 
word trace table control block. The trace 
table control block immediately preceeds 
the table. The trace table control block 
describes the bounds of the table and the 
most recent entry at the time of the dump. 



SIO entries can be used to locate the CCW 
(through the CAW) , which reflects the 
operation initiated by an SIO instruction. 
If the SIO operation was not successful, 
the CSW STATUS portion of the entry will 
show you why it failed. 

I/O entries reflect the I/O old PSW and the 
CSW that was stored when the interruption 
occurred. From the PSW, you can learn the 
address of the device on which the 
interruption occurred (bytes 2 and 3), the 
CPU state at the time of interruption (bit 
15), and the instruction address where the 
interruption occurred (bytes 5-8) . The CSW 
provides you with the unit status (byte 4), 
the channel status (byte 5) , and the 
address of the previous CCW plus 8 (bytes 
0-3). 
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Figure 37. Trace Table Entries (MVT) 
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Figure 38. Trace Table Entries (MVT with Model 65 multiprocessing) 



SVC entries provide the SVC old PSW and the SIO 

contents of registers and 1. The PSW 

offers you the hexadecimal SVC number (bits 

20-31), the CPU mode (bit 15), and the 

address of the SVC instruction (bytes 5-8). 

The contents of registers and 1 are 

useful in that many system macro 

instructions use these registers for 

parameter information. Contents of 

registers and 1 for each SVC interruption 

are given in Appendix B. 



I/O 



SVC and 
Program 



Trace Table Entries in MVT and M65MP : 
Entries in an MVT trace table are 8 words 
long and represent occurrences of SIO, 
external, SVC, program, I/O, and dispatcher 
interruptions. You can identify what type 
of interruption caused an entry by looking 
at the fifth digit : 

= SIO 

1 = External 

2 = SVC 

3 = Program 

5 = I/O External 

D = Dispatcher 

Figure 40 gives some sample entries and 
their contents. 

In dumps of Model 65 Multiprocessing 
system, trace table entries differ as 
follows I 



7th word: 
8th word 
3rd word: 
4th word 
8th word 
6th word: 
7th word: 
8th word 
Dispatcher 6th word: 
7th word: 
8th word: 



5th word address of TCB. 
6th word: address of old TCB 

for CPU A. 

address of old TCB 

for CPU B. 

CPU identification 

(last byte) . 

contents of register 

15. 

contents of register 

0. 

CPU identification 

(last byte). 

address of old TCB 

for APU A. 

address of old TCB 

for CPU B. 

CPU identification 

(last byte) . 

address of new TCB 

for CPU A. 

address of new TCB 

for CPU B. 

CPU identification 

(last byte) . 
6th word: STMASK of other CPU- 
7th word: TQE if timer inter- 
rupt occurred. 
8th word: CPU identification 

(last byte) . If so, a 

program check at the 

instruction preceding 

that address caused 

the interruption. 
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Figure 39. Sample Trace Table Entries 
(MFT) 



Generalized Trace Facility 

The Generalized Trace Facility (GTF) traces 
system and application program events and 
records information about these events. 
Trace records can be stored internally — 
in a table similiar to the trace table of 
the Trace Option — or they can be recorded 
externally in a data set that becomes input 
to the IMDPRDMP service aid program. (When 
stored internally the trace table is^ 
formatted in ABEND/SNAP dumps.) The* 
IMDPRDMP service aid edits and formats the 
GTF external trace records as specified in 
an EDIT control statement. 

This section describes the output of 
GTF; it does not tell how to use GTF. For 
a description of the functions performed by 
GTF and IMDPRDMP refer to the Service Aids 
publication. 
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External 
Program 
Dispatcher 



mi 



4PPQ6AC& r ?oo o #S 0, 



SVC old PSW 



1& ( 



Register 15 Register 



Ompm 00000000 flOQiaffi ft ,08iede60, 



Register 1 



TCB address 



Timer 



Figure 40. Sample Trace Table Entries 
(MVT) 

System events traced by GTF in MFT, MVT, 
and MVT-M65MP systems are: 

10 interrupts 

SIO operations 

SVC interrupts 

Program interrupts 

External interrupts 

Task Switches by the system dispatcher 

SSM interrupts in multi-processing 

systems 



GTF MINIMAL TRACE RECORDS 

The following material describes the 
records produced n.jder the minimal trace 
option (SYSM) of GTF. The formats 
described appear in both ABEND/SNAP dumps 
(under the heading GTF TRACE TABLE) and in 
IMDPRDMP output. Minimal trace records are 
produced for IO and PCI/IO, SIO, SVC, PGM, 
EXT, DSP, and SSM events. 
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10 and PCI/ 10 Minimal Trace Record 



/ w __ v (********W0LA hhhhhhhh OL 

(Bl IPCIf 0LD PSW hhhhhhhh hhhhhhhh CSW hhhhhhhh hhhhhhhh RQE TCBJhhhhhhhhHOLD TCB hhhhhhhh 



OLB hhhhhhhh) 



Figure 41,. 10 and PCI/IO Minimal Trace Record 



ft} 



appears in MVT-M65MP system records; 
identifies the CPU associated with the 
event. 



hhhhhhhh 

is the address of the TCB of the 
task for which this I/O operation 
is being performed. 



10 \ 
PCI J 



N/A 



identifies the type of trace record. 



OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the 10 or PCI/IO 
interrupt occurred. 

CSW hhhhhhhh hhhhhhhh 

the channel status word associated 
with the 10 or PCI/IO interrupt being 
traced. 

!********} 
hhhhhhhh/ 
N/A ) 

******** 

indicates that an error occurred 
while gathering the information. 



indicates the interrupt was 
unsolicited: either the I/O 
supervisor did not issue an SIO 
instruction to the device; or 
there is no valid UCB for the 
device. 



OLD TCB hhhhhhhh 

in MPT and MVT system trace records, 
the address of the TCB for the task 
that was in control when the interrupt 
occurred. 

in MVT-M65MP systems the OLA and OLB 
fields replace the OLD TCB field and 
contain the address of the TCB for the 
task in control of CPU A and CPU B 
respectively, at the time the 
interrupt occurred. 
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SIO Minimal Trace Record 



. . (******** WOLA hhhhhhhh OLB hhhhhhhh) 

<g| SIO CC/DEV/CAW hhhhhhhh hhhhhhhh CSW hhhhhhhhhhhhhhhh RQE TCB< hhhhhhhh VOLD TCB hhhhhhhh > 



Figure 42. SIO Minimal Trace Record 



{£} 



SIO 



appears in MVT-M65MP system records; 
identifies the CPU associated with the 
event . 



identifies the type of trace record. 



CC/DEV/CAW hhhhhhhh hhhhhhhh 

displays the SIO condition code, the 
device address, and the CAW (channel 
address word) for the I/O operation 
just initiated. 

The first four digits represent the 
condition code returned from the SIO 
operation; the next four digits 
represent the device address; and the 
last eight digits represent the CAW. 

CSW hhhhhhhh hhhhhhhh 

the channel status word associated 
with this event. 

{********! 
hhhhhhhh? 
N/A ) 



******** 

indicates that an error occurred while 
gathering the information. 



hhhhhhhh 

is the address of the TCB of the task 
for which this I/O operation is being 
performed. 

N/A 

indicates the interrupt was 
unsolicited, i.e., the I/O supervisor 
did not issue an SIO instruction to 
the device; or, there is no valid UCB 
for the device. 

OLD TCB hhhhhhhh 

in MFT and MVT system trace records, 
the address of the TCB for the task 
that was in control when the interrupt 
occurred. 

In MVT-M65MP systems the OLA and OLB 
fields replace the OLD TCB field and 
contain the address of the TCB for the 
task in control of CPU A and CPU B 
respectively, at the time the 
interrupt occurred. 
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DSP Minimal Trace Record 



, v /NUA hhhhhhhh NUB hhhhhhhh) 

<„> DSP J^S psw i hhhhhhhh hhhhhhhh R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh \NEW TCB hhhhhhhh f 

l B J {NEW PSW/ 



Figure 43. DSP Minimal Trace Record 



{S} 



DSP 



appears in MVT-M65MP records; 
identifies the CPU associated with the 
event . 



identifies the type of record. 



NEW Psw hhhhhhhh hhhhhhhh 

the PSW for the task about to be 
dispatched. 

In a record obtained from a MVT-M65MP 
system this field will be labeled RES 
PSW. 

R15/R0 hhhhhhhh hhhhhhhh 

the contents of general purpose 



registers 15 and as they will be 
when the task being dispatched is 
given control. 

Rl hhhhhhhh 

the contents of general purpose 
register 1 as it will be when the task 
being dispatched is given control. 

NEW TCB hhhhhhhh 

the address of the TCB for the task 
about to be dispatched. 

In a record obtained from a MVT-M65MP 
system this field is replaced by the 
NUA and NUB fields containing the 
addresses of the tasks to be 
dispatched on CPU A and CPU B when 
processing resumes. 
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EXT Minimal Trace Record 



/********) 



Ml EXT OLD PSW hhhhhhhh hhhhhhhh R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh STMSK hhhhhhhh TQE TCBJhhhhhhhhJ 



Figure 44. EXT Minimal Trace Record 



IS} 



appears in MVT-M65MP records; 
identifies the CPU associated with 
event. 



the 



STMSK hhhhhhhh 

appears in MVT-M65MP records only; 
displays the SHOULDER TAP MASK at the 
time the interrupt occurred. 



EXT 



identifies the type of trace record. 



OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the external 
interrupt occurred. 

R15/R0 hhhhhhhh hhhhhhhh 

the contents of general purpose 
registers 15 and at the time the 
interrupt occurred. 

Rl hhhhhhhh 

the contents of general purpose 
register 1 at the time the interrupt 
occurred. 



!********! 
hhhhhhhh \ 
N/A J 



******** 

indicates that an error occurred 
while gathering the information. 

hhhhhhhh 

is the address of the TCB of the 
task that requested this timer 
interrupt. 



N/A 



indicates the interrupt was other 
than a timer interrupt. 
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PGM Minimal Trace Record 



ft} 



PGM OLD PSW hhhhhhhh hhhhhhhh R15/R0 hhhhhhhh hhhhhhhli 



(OLA hhhhhhhh OLB hhhhhhhh) 
Rl hhhhhhhh (OLD TCB hhhhhhhh J 



Figure 45. PGM Minimal Trace Record 



m 



appears in MVT-M65MP system records; 
identifies the CPU associated with the 
event- 



Rl hhhhhhhh 

the contents of general purpose 
register 1 at the time the interrupt 
occurred. 



PGM 



identifies the type of trace record. 



OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the program 
interrupt occurred. 

R15/R0 hhhhhhhh hhhhhhhh 

the contents of general purpose 
registers 15 and at the time the 
interrupt occurred. 



OLD TCB hhhhhhhh 

the address of the TCB for the task 
that was in control when the interrupt 
occurred. 



In MVT-M65MP trace records this field 
is replaced by the OLA and OLB fields 
that contain, respectively, the 
address of the TCB for the tasks in 
control of CPU A and CPU B at the time 
the interrupt occurred. 
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SVC Minimal Trace Record 



A) /OLA hhhhhhhh OLB hhhhhhhh) 

B > SVC OLD PSW hhhhhhhh hhhhhhhh R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh (OLD TCB hhhhhhhh / 



Figure 46. SVC Minimal Trace Record 



{b} 



SVC 



appears in MVT-M65MP system records; 
identifies the CPU associated with the 
event . 



identifies the type of trace record. 



OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the interrupt 
occurred. The SVC number, e.g., SVC 
51, is represented by the last two 
hexadecimal digits in the first word. 

R15/R0 hhhhhhhh hhhhhhhh 

the contents of general purpose 



registers 15 and at the time the 
interrupt occurred. 

Rl hhhhhhhh 

the contents of general purpose 
register 1 at the time the interrupt 
occurred. 

OLD TCB hhhhhhhh 

the address of the TCB for the task 
that issued the SVC. 

In MVT-M65MP systems the OLA and OLB 
fields replace the OLD TCB field and 
contain the address of the TCB for the 
task in control of CPU A and CPU B 
respectively, at the time the 
interrupt occurred. 
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SSM Minimal Trace Record 



{£} »" 



LK C OPSW hhhhhhhh hhhhhhhh R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh OLA hhhhhhhh OLB hhhhhhhh 



Figure 47- SSM Minimal Trace Record 



{b} 



SSM 



IK c 



indicates the CPU associated with the 
event. 



identifies the type of trace record. 



CPU affinity byte: 

A indicates CPU A executing 

disabled. 

B indicates CPU B executing 

disabled. 

Neither CPU executing disabled. 



OPSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the interrupt 
occurred. Obtained from the CPU on 
which the interrupt occurred. 

R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh 
The contents of general purpose 
registers 15, 0, and 1 from the CPU on 
which the interrupt occurred, at the 
time the interrupt occurred. 

OLA hhhhhhhh OLB hhhhhhhh 

the addresses of the TCBs of the tasks 
in control in CPU A and CPU B 
respectively at the time the interrupt 
occurred. 
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GTF COMPREHENSIVE TRACE RECORDS in the output from IMDPRDMP service aid 

processing of the data recorded by GTF- 
The following material describes the 

records produced when comprehensive tracing Comprehensive trace records are produced 
is specified at the invoking of GTF for 10 , PCI/10, SIO, DSP r EXT, PGM, SSM, 

(MODE=EXTK The formats described appear and SVC events. 
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10 and PCI/10 Comprehensive Trace Record 



(B/ {pCI/ 



•********\ <********) tOLh hhhhhhhh OLE hhhhhhhh! 

cuu OLD PSW hhhhhhhh hhhhhhhh JOBN<cccccccc> DDNM<cccccccc/ \OLTCB hhhhhhhh ) 



(n/a 



(n/a 






/******** ******** ********} 



i /******* * l 

CSW hhhhhhhh hhhhhhhh RQE{hhhhhhhh hhhhhhhh hhhhhhhh) RQE TCB{hhhhhhhh[ SENS (hhhhhhhhi 

(N/A J (N/A ) (N/A ) 



Figure 48. 10 and PCI/IO Comprehensive Trace Record 



ft} 



I 10 \ 
(PCI) 



cuu 



This field appears only in MVT-M65MP 
system I/O or PCI trace records and 
identifies the computer associated 
with the event. 



This field identifies the type of 
trace record — input/output (10) or 
program controlled interrupt (PCI). 



UCB for the device issuing the 
interrupt. 



This field displays the device address 
for the device associated with the 
interrupt in channel/unit form. 

OLD PSW hhhhhhhh hhhhhhhh 

This field displays the program status 
word that was current at the time the 
10 or PCI interrupt being traced, 
occurred. 

! cccccccc) 
********> 
N/A ) 

This field has three possible entries, 
as follows : 

cccccccc 

is the one to eight character 
name of the job associated with 
the interrupt being traced. 

******** 

asterisks indicate that a bad 
control block chain prevented the 
jobname from being obtained. 



N/A 



in PCI trace records N/A 
indicates that the interrupt was 
issued by the system and there is 
no associated jobname? in 10 
interrupt trace records N/A 
indicates either a system issued 
interrupt as for PCI or an 
interrupt issued without a valid 



! cccccccc i 
***+****\ 
N/A ) 



This field has three possible entries, 
as follows: 

cccccccc 

is the name of the DD statement 
associated with the interrupt 
being traced. 

******** 

asterisk indicate that a bad 
control block chain prevented the 
data definition name from being 
obtained. 

N/A 

N/A appears in the DDNM field for 
one of the following reasons: 

• An interrupt was issued without 
a valid UCB for the device 
issuing the interrupt. 

• The post bit in the UCB is 
•off.' 

• The data event block (DEB) 
pointer to the TCB is set to 0. 

• The DCB is not opened. 

• The DCB TIOT offset is outside 
the valid range. 

• The TCB TIOT pointer is set to 
0. 

• The DDNAME in the TIOT is not 
recorded in EBCDIC characters. 

OLTCB hhhhhhhh 

In MFT and MVT system trace records 
this field displays the address of the 
TCB that was current at the time the 
10 or PCI interrupt being traced, 
occurred. 

In MVT-M65MP system 10 and PCI trace 
records the following fields replace 
the OLTCB field: 
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OLA hhhhhhhh 

This field displays the address 
of the A computer TCB that was 
current when the IO or PCI 
interrupt occurred. 

OLB hhhhhhhh 

This field displays the address 
of the B computer TCB that was 
current when the 10 or PCI 
interrupt occurred. 

CSW hhhhhhhh hhhhhhhh 

This field displays the channel status 
word from permanent storage location 
64. 

(hhhhhhhh hhhhhhhh hhhhhhhh) 

RQE<******** ******** ********> 



;/******** ******** 
( N/A 



This field has three possible entries 
as follows: 

hhhhhhhh hhhhhhhh hhhhhhhh 

is the content of the first three 
words of the Request Queue 
Element associated with the 10 or 
PCI interrupt. 

******** ******** ******** 

asterisks indicate that a bad 
control block chain prevented the 
RQE information from being 
obta ined . 



(hhhhhhhh) 

RQE TCB< ********> 

( N/A ) 

This field has three possible entries 
as follows: 

hhhhhhhh 

is the address of the TCB 
associated with the Request Queue 
Element 

******** 

asterisks indicate that a bad 
control block chain prevented the 
TCB address from being obtained. 



N/A 



indicates that the interrupt was 
issued without a valid UCB for 
the device issuing the interrupt, 



SENS J hhhhhhhh) 
I N/A J 



This field has two possible entries as 
follows: 

hhhhhhhh 

is the content of the four sense 
bytes in the UCB beginning at UCB 
♦ 22 which describe the 10 or PCI 
interrupt being traced. For more 
information about the sense oytes 
see Appendix G. 



N/A 



N/A 



indicates that the interrupt was 
issued without a valid UCB for 
the device issuing the interrupt. 



indicates that the interrupt was 
issued without a valid UCB for 
the device issuing the interrupt. 
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SIO Comprehensive Trace Record 



(A v fOLA hhhhhhhh OLB hhhhhhhhl 

|g| SIO cuu CC hh CAW hhhhhhhh JOBNfcccccccc»\OLTCB hhhhhhhh ) 

CSW hhhhhhhh hhhhhhhh RQE hhhhhhhh hhhhhhhh hhhhhhhh RQE TCB hhhhhhhh 



Figure 49. SIO Comprehensive Trace Record 



{£} 



appears in MVT-M65MP system trace 
records; identifies the computer 
associated with the event. 



OLTCB hhhhhhhh 

in MFT/MVT systems the address of the 
TCB that was current when the SIO was 
issued. 



SIO 



the type of trace record. 



in MVT-M65MP systems the OLA and OLB 
fields replace the OLTCB field. 



cuu 



the device address in channel /unit 
form for the device associated with 
the record. 

CC hh 

hh - is the condition code set by the 
SIO event. 

CAW hhhhhhhh 

the channel address word associated 
with this event — taken from 
permanent storage location 72. 



JOBN f cccccccc \ 
\ N/A ) 



cccccccc 

is the one to eight character 
job name of the job associated 
with this event. 



N/A 



indicates the SIO was issued by 
the system and there is no 
associated jobname. 



OLA hhhhhhhh 

is the A computer address of the 
TCB that was current when the SIO 
was issued. 



OLB hhhhhhhh 

is the B computer address of the 
TCB that was current when the SIO 
was issued. 



CSW hhhhhhhh hhhhhhhh 

the channel status word associated 
with this event — taken from 
permanent storage location 64. 

RQE hhhhhhhh hhhhhhhh hhhhhhhh 

the first three words of the Request 
Queue Element associated with the SIO 
operation. 

RQE TCB hhhhhhhh 

the address of the TCB associated with 
the request queue element. 
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DSP Comprehensive Trace Record 



ft} 



DSP RES PSW hhhhhhhh hhhhhhhh 



JOBN jcccccccci MODN 

\n/a ; 



PWAITTCB 
SVC-cccc| 

I SVC- RES 
**IRB***J 
ccccccccl 
Iccccccc] 
99999999i 



/NUA hhhhhhhh NUB hhhhhhhh) 

{NUTCB hhhhhhhh JPRTY hh 



Figure 50. DSP Comprehensive Trace Record 



{*} 



DSP 



MVT-M65MP systems only. Identifies 
the computer associated with the 
ev ent . 



the type of trace record. 



RES PSW hhhhhhhh hhhhhhhh 

the PSW for the task about to be 
dispatched. If this task was 
interrupted at some previous point in 
time, then this was the current PSW at 
the interrupt. 

JOBN fccccccccl 
I N/A J 

cccccccc 

is the eight character name of 
the job associated with the task 
being dispatched. 



N/A 



indicates the task switch is for 
a system task; no jobname is 
available. 



WAITTCB 
.svc-cccc] 

MODN 1SVC-RES 
**IRB*** 
/ccccccccl 
'Iccccccc 
I \99999999 



WAITTCB 

the WAIT task is about to be 
given control . 

SVC-cccc 

indicates a type 3 or 4 SVC is 
about to get control; cccc is the 
last four characters in the 
module name. 

SVC -RES 

indicates a resident type SVC 
routine is about to be given 
control . 



**IRB*** 

an asynchronous routine is about 
to be dispatched and the module 
name is not available. 

cccccccc 

in MVT systerrs the eight 
character module name from the 
CDE associated with the task to 
be dispatched; or, the name of an 
error exit routine from the SIRB 
associated with the task. 

in MFT systems the eight 
character narre from the LRB, 
LPRB, PRB or FRB associated with 
the task being dispatched; or an 
error exit routine name from the 
SIRB associated with the task. 

Iccccccc 

indicates that error fetch is in 
the process of loading an error 
recovery module. The last seven 
characters of the module name are 
shown. 

99999999 

In MFT (with subtasking) an 
ATTACH was issued, but the module 
requested did not receive 
control. 

NUTCB hhhhhhhh 

the address of the new TCB — the TCB 
of the next -to-be-dispatched task. 

in MVT-M65MP systems the following 

fields replace the NUTCB field: 

NUA hhhhhhhh 

the address of the TCB of the 
next -to-be-dispatched task in the 
A computer. 

NUB hhhhhhhh 

the address of the TCB of the 
next- to-be-dispatched task in the 
B computer. 



PRTY hh 



hh 



the dispatching priority of the 
next-to-be-dispatched task. 
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EXT Comprehensive Trace Rec ord 



fWAITTCB 
SVC-ccccI 



, . . JfOLA hhhhhhhh OLE hhhhhhhh! 

<g> EXT OLD PSW hhhhhhhh hhhhhhhh JOBN (ccccccccl MODNl=»C-ras n 0LTCB hhhhhhhh ( STMSK hhhhhhhh 



| CCCCCCCC! 

Iccccccc! 
199999999/ 



hhhhhhhh) EXIt| hhhhhhhh) 
N/A ) (n/A J 



Figure 51. EXT Comprehensive Trace Record 



il) 



EXT 



This field appears only in MVT-M65MP 
system EXT trace records and 
identifies the computer associated 
with the event. 



This field identifies the trace record 
as an EXT trace record. 



OLD PSW hhhhhhhh hhhhhhhh 

This field displays the program status 
word that was current at the time the 
external interrupt occurred. 

JOBN (cccccccc) 
( N/A f 

This field has two possible entries as 
follows : 

cccccccc 

is the one to eight character 
name of the job associated with 
the event. 



SVC- RES 

a resident SVC routine was 
interrupted. 



**IRB*** 

the EXT interrupt occurred during 
execution of an asynchronous 
routine with an associated IRB. 



cccccccc 

in MVT systems the eight 
character name of the module that 
was interrupted - taken from the 
CDE associated with the task; or 
the name of an error routine - 
taken from the SIRB associated 
with the task. 

in MFT systems the eight 
character naire of the module that 
was interrupted - taken from 
either the LRB, LPRB, PRB, or 
FRB; or the name of an error 
routine - taken from the SIRB 
associated with the task. 



N/A 



indicates that the interrupt was 
issued by the system and there is 
not associated job name. 



WAITTCB 
^SVC-cccc 
MODN ) SVC- RES 
**IRB*** 

fcccccccc| 

Iccccccc 
99999999 



WAITTCB 

The WAIT task was interrupted. 

SVC-cccc 

A type 3 or 4 SVC routine was 
interrupted; cccc is the last 
four characters of the routine 
name. 



Iccccccc 

indicates that error fetch was in 
the process of loading an error 
recovery routine when the 
interrupt occurred. The last 
seven characters of the module 
name are shown. 

99999999 

In MPT (with subtasking) an 
ATTACH was issued, but the module 
requested did not receive 
control. 

OLTCB hhhhhhhh 

In MFT/MVT systems the address of the 
TCB that was current when the 
interrupt occurred. 

In MVT-M65MP systems the OLA and OLB 
fields replace the OLTCB field. 
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OLA hhhhhhhh 

is the address of the TCB in the 
A computer that was current when 
the interrupt occurred. 

OLB hhhhhhhh 

is the address of the TCB in the 
B computer that was current when 
the interrupt occurred. 

STMSK hhhhhhhh 

In MVT-M65MP systems only - the 
•shoulder tap' mask from location 
X'2BC* in the other computers prefix. 

(N/A ) 
TQEFLG/TCB< ********> 

(hhhhhhhh) 

hhhhhhhh 

is the first word of the timer 
queue element (TQE). The first 
byte of the word is the TQEFLGS 
and the remaining three bytes the 
TQETCB, which is the address of 
the TCB for the task in which 
this timer element is being used. 



******** 

asterisks indicate that a bad 
control block chain prevented the 
information from being obtained. 



N/A 



indicates that this EXT interrupt 
was not caused by the timer. 



(hhhhhhhh) 

EXIT< N/A / 
f********J 



hhhhhhhh 

is the address of the exit 
routine - taken from the eighth 
word of the TQE. 



N/A 



indicates that this EXT interrupt 
was not caused by the timer. 



******** 

asterisks indicate that a bad 
control block chain prevented the 
information from being obtained. 
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PGM Comprehensive Trace Records 



G} 



PGM ccc OLD PSW hhhhhhhh hhhhhhhh 



JODN/cccececcl 

)n/a ; 



MODN 



rWAITTCB 
SVC-ccccI 

ISVC-RES 
**IRB***] 

(ccccccccl 
Iccccccc 

>99999999J 



(OLA hhhhhhhh OLB hhhhhhhh) 
\OLTCB hhhhhhhh J 



RO hhhhhhhh 
R8 hhhhhhhh 



Rl hhhhhhhh R2 hhhhhhhh R3 hhhhhhhh R4 hhhhhhhh R5 hhhhhhhh R6 hhhhhhhh R7 hhhhhhhh 
R9 hhhhhhhh RIO hhhhhhhh Rll hhhhhhhh R12 hhhhhhhh R13 hhhhhhhh R14 hhhhhhhh R15 hhhhhhhh 



Figure 52. PGM Comprehensive Trace Record 



fil 



PGM 



ccc 



MVT-M65MP systems only; identifies the 
computer associated with the 
interrupt. 



the type of trace record. 



the completion code for the program 
interrupt. 

OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the program 
interrupt occurred. 

fccccccccl 
JOBN| N/A J 

cccccccc 

is the one to eight character 
jobname of the job associated 
with this event. 



N/A 



indicates a system task program 
checked and no jobname is 
available. 



WAITTCB 
iSVC-cccc 
MODN ]SVC-RES 
**IRB*** 
| CCCCCCCC I 

Iccccccc 
99999999 



SVC-ccc 

A type 3 or a SVC routine was 
interrupted; cccc is the last 
four characters of the routine 
name. 

SVC-RES 

a resident SVC routine was 
interrupted. 



**IRB*** 

the program check interrupt 
occurred in an asynchronous 
routine with an associated IRB. 

cccccccc 

in MVT systems the eight 
character name of the module that 
was interrupted - taken from the 
CDE associated with the task; or, 
the name of an error routine - 
taken from the SIRB associated 
with the task. 

Iccccccc 

indicates that error fetch was in 
the process of loading an error 
recovery routine when the 
interrupt occurred. The last 
seven characters of the module 
name are shown. 

99999999 

In MFT (with subtasking) an 
ATTACH was issued, but the module 
requested did not receive 
control. 

OLTCB hhhhhhhh 

in MFT/MVT systems the address of the 
TCB that was current when the 
interrupt occurred. 

In MVT-M65MP systems the OLA and OLB 
fields replace the OLTCB field. 

OLA hhhhhhhh 

is the A computer address of the 
TCB that was current when the 
interrupt occurred. 

OLB hhhhhhhh 

is the B computer address of the 
TCB that was current when the 
interrupt occurred. 

RO hhhhhhhh 
to 

R15 hhhhhhhh 

the content of general purpose 
registers zero through fifteen at the 
time of the interrupt. 



Section 3: Tracing Aids 165 



SSM Comprehensive Trace Record 



{£} 



SSM OLD PSW hhhhhhhh 



JOBN f cccccccc} 
\N/A ) 



! WAITTCB 
SVC-Cccc 
SVC-RES 
**IRB*** 
cccccccc 
Iccccccc 



OLA hhhhhhhh OLB hhhhhhhh LKID C 



Figure 53. SSM Comprehensive Trace Record 



It} 



SSM 



identifies the computer associated 
with the SSM interrupt. 



identifies this trace record as an SSM 
trace record. 



OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the set system 
mask instruction was issued. 

JOBN fcccccccc \ 
\ N/A J 

cccccccc 

is the one to eight character 
name of the job associated with 
SSM interrupt. 



N/A 



indicates that the system 
originated the interrupt and 
there is no associated jobname. 



WAITTCB 
SVC-CCCC i 
MODN{ SVC-RES 
**IRB*** 
Iccccccc 



WAITTCB 

the WAIT task was interrupted. 

SVC-cccc 

a type 3 or 1 SVC routine was 
interrupted; cccc is the last 
four characters of the routine 
name. 

SVC-RES 

a resident SVC routine was 
interrupted . 



**IRB*** 

the SSM interrupt occurred during 
execution of an asynchronous 
routine with an associated IRB. 



cccccccc 

the eight character name of the 
module that was interrupted - 
taken from the content directory 
element (CDE) for the task; or 
the name of an error routine - 
taken from the SIRB associated 
with the task. 



Iccccccc 

indicates that error fetch was in 
the process of loading an error 
recovery routine when the 
interrupt occurred. The last 
seven characters of the module 
name are shown. 



OLA hhhhhhhh 

is the A computer address of the TCB 
that was current when the interrupt 
occurred. 



OLB hhhhhhhh 

is the B computer address of the TCB 
that was current when the interrupt 
occurred. 



LKID c 

CPU affinity byte: 

A indicates CPU A executing 

disabled. 
B indicates CPU B executing 

disabled. 
Neither CPU executing disabled, 
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TIME AND LOST EVENT RECORDS 

GTF produces two types of time records and 
a lost event record as follows: 



TIME ddddd.dddddd 



TIME dd.dd.dd 

is the time since midnight in a 
twenty-four hour format 
(hours. minutes. seconds) . 

*** LOST EVENTS: NUM dddddddddd TIME 
dd.dd.dd [GTF DISABLED] 



appears on the last line of every 
event record if TIME=YES was specified 
in the GTF start command, and 
designates in decimal the number of 
seconds and microseconds since the 
last midnight - 



***DATEs DAY ddd YEAR dddd TIME dd.dd.dd 



This timestamp record appears at the 
beginning of the printout of each 
buffer filled by GTF and represents 
the time the first record was placed 
in the buffer. 



DAY ddd 

is the Julian date. 



YEAR dddd 

is the year. 



The lost event record appears whenever 
GTF loses records, whether it is 
because the GTF buffers overflowed or 
because GTF was temporarily disabled 
by ABEND. The record is not produced 
if GTF terminates when the buffers are 
full. 

NUM dddddddddd 

is the number of records that 
were lost; one to ten decimal 
digits. 

TIME dd.dd.dd 

is the time GTF resumed 
recording; 24-hour format 
starting at midnight. 

GTF DISABLED 

appears only if the events were 
lost because GTF was temporarily 
disabled, e.g., ABEND temporarily 
disables GTF in order to format 
GTF output for an ABEND dump. 
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HEXADECIMAL FORMAT RECORD 



HEXFORMATi 
USER | 
SYSTEM j 
SUBSVS ) 



AID hh FID hh EID hh 



hhhhhhhh hhhhhhhh hhhhhhhh 



/ 



hhhhhhhh 



Figure 54. Hexadecimal Format Record 



Under some circumstances IMDPRDMP formats 
and prints GTF records in hexadecimal 
notation. The conditions under which GTF 
records are formatted and printed in 
hexadecimal format by IMDPRDMP are 
presented in the discussion of the 
hexformat record that follows: 

HEXFORMAT 

This label identifies a record dumped 
in hex format at the request of the 
user on a GTRACE macro. This request 
was made by not specifying a format 
appendage, that is FID=00. 

USR 

This label identifies this record as 
dumped in hexformat because the user 
requested a format appendage on the 
GTRACE macro that could not be found. 
This format appendage was identified 
by FID=hh, and therefore its name is 
IMDUSR hh. 

SYSTEM 

This label identifies a record that 
was dumped in hex format because 
either it is a GTF error record or the 
format appendage for it has been 
scratched by the user. If relative 
bytes f 1 or 8, 9 contain X'EEEE', 
then this is an error record produced 
by GTF. This error record was 
produced as a result of an 
unrecoverable error in a GTF data 
gathering routine. When the error was 
encountered message IHL118I was 
written on the master system console 
indent if ying the error and the action 
taken. This message is not issued if 
the error occurred while building a 
comprehensive SVC trace record. 



Except for comprehensive SVC records, 
this was the last record of its type 
produced during the run of GTF that 
produced it. If the X'EEEE' were not 
in the record, then it was dumped in 
hexformat because the IMDPRDMP format 
appendage that formats this type of 
record was not found by IMDPRDMP. 

SUBSYS 

This label identifies this record as 
dumped in hexformat because the 
subsystem format appendage requested 
by the subsystem on a GTRACE was not 
found by IMDPRDMP. The request was 
made via FID=hh, and therefore, it's 
name is IMDUSRhh. 

AID hh 

This field contains the AID of this 
record, and should always be X'FF*. 
The AID is the application identifier, 
and GTF's is always X'FF'. 

FID hh 

This field contains the FID, or format 
identifier. It is appended to 
•IMDSYS' or 'IMDUSR* to obtain the 
name of the format appendage that was 
to have formatted this record. 

EID hhhh 

This field contains the EID, or event 
identifier, for this record. The EID 
uniquely identifies the event that 
produced this record. 

hhhhhhhh hhhhhhhh hhhhhhhh hhhhhhhh 

up to 64 words (256 bytes) of record 
in the GTF internal format. The 
internal format of GTF records is 
available in the Service Aids PLM. 
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GTF SVC COMPREHENSIVE TRACE RECORDS 

There are four groups of GTF SVC 
Comprehensive Trace records. 

Group 1 — Those with Basic Fields 

Group 2 — Those with Basic Fields plus 

a DDNAME Field 

Group 3 — Those with Basic Fields plus 

a Parameter List Field 

Group 4 — Those with Basic Fields plus 

Variable Field (s) 

The following sub-index lists the SVCs in 
sequence, identifies the group to which 
they belong, and gives the page where 
register contents and other variable fields 
are noted. 



SVC # 


Group 


Paqe 





4 


190 


1 


3 


182 


2 


1 


170 


3 


1 


171 


4 


3 


182 


5 


3 


183 


6 


4 


190 


7 


4 


190 


8 


4 


190 


9 


4 


191 


10 


3 


171 


11 


1 


171 


12 


1 


171 


13 


4 


191 


14 


4 


191 


15 


4 


191 


16 


4 


191 


17 


4 


192 


18 


3 


183 


19 


3 


183 


20 


3 


183 


21 


4 


192 


22 


3 


183 


23 


3 


183 


24 


2 


181 


25 


4 


192 


26 


4 


193 


27 


4 


194 


28 


4 


195 


29 


4 


195 


30 


4 


195 


31 


2 


181 


32 


4 


195 


33 


4 


195 


34 


1 


171 


35 


3 


183 


36 


1 


171 


37 


3 


184 


38 


1 


171 


39 


3 


184 


40 


3 


184 


41 


4 


196 


42 


4 


196 


43 


1 


171 


44 


4 


197 



SVC # 


Group 
3 


Paqe 


45 


185 


46 


1 


172 


47 


3 


185 


48 


3 


185 


49 


1 


172 


50 null 






51 


4 


197 


52 


1 


172 


53 


2 


181 


54 


4 


198 


55 


2 


181 


56 


3 


186 


57 


2 


181 


58 


2 


181 


59 


1 


172 


60 


3 


186 


61 


1 


172 


62 


4 


198 


63 


3 


187 


64 


3 


187 


65 


4 


198 


66 


4 


199 


67 


4 


199 


68 


1 


172 


69 


2 


181 


70 


3 


187 


71 


4 


199 


72 


1 


173 


73 


3 


187 


74 


3 


187 


75 


4 


199 


76 


1 


173 


77 


3 


187 


78 


4 


200 


79 


1 


173 


80 


3 


188 


81 


4 


200 


82 


4 


200 


83 


1 


173 


84 


1 


173 


85 


1 


173 


86 


4 


201 


87 


3 


188 


88 


4 


202 


89 


4 


202 


90 


3 


188 


91 


1 


173 


92 


1 


173 


93 


1 


174 


94 


1 


175 


95 


1 


177 


96 


3 


188 


97 


1 


178 


98 


4 


202 


99 


3 


189 


100 


1 


178 


101 


1 


179 


102 


3 


189 


103 


1 


179 


104 


1 


179 


105 


1 


180 


109 


1 


180 


116 


1 


180 


117 


1 


180 
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SVC Comprehensive Trace Records Group 1 — Basic Fields 



, ak /OLA hhhhhhhh OLD hhhhhhhht 

<g> SVC ddd OLD PSW hhhhhhhh hhhhhhhh JOBN cccccccc MODN cccccccc \OLTCB hhhhhhhh / 



R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh 



Figure 55. Basic SVC Comprehensive Trace Record 



{1} 



this field appears only in MVT-M65MP 
records and identifies the CPU 
associated with the event. 



SVC ddd 

the decimal number of the SVC 



OLD PSW hhhhhhhh hhhhhhhh 

the program status word that was 
current at the time the SVC interrupt 
occurred. When SVC processing is 
completed, operation is resumed under 
control of this PSW. 



SVC- RES 

indicates the SVC was issued by a 
resident SVC with an associated 
SVRB. 

SVC-nnn 

indicates the SVC was issued by a 
transient SVC module with an 
associated SVRB. nnnn denotes 
the last four characters of the 
module name. 

♦ccccccc 

indicates that error fetch is in 
the process of loading an error 
recovery module, ccccccc is the 
last seven characters of the 
module name. 



!********\ 
cccccccc > 
N/A ) 



******** 

indicate an error occurred while 
attempting to retrieve the 
jobnarae, e.g., an incorrect TIOT 
address in the TCB could result 
in asterisks being placed in this 
field. 

cccccccc 

is the eight character jobname of 
the job issuing the SVC. 



cccccccc 

is, in MVT systems, the eight 
character name of the module 
issuing the SVC — taken from the 
CDE associated with the task; or 
the name of an error routine — 
taken from the SIRB associated 
with the task. 

In MFT systems the module name is 
taken from the LRB, LPRB, PRB, or 
FRB and the error routine name is 
taken from the SIRB associated 
with the task. 



N/A 



N/A 



indicates that the SVC was issued 
by the system and there is no 
associated jobname. 



indicates the RB CDE pointer was 
zero. 



**IRB*** 
SVC-RES 
MODN \ SVC -nnnn 
♦ccccccc I 
\cccccccc 

N/A 
******** 

f \99999999 



******** 

indicates that an error occurred 
while attempting to retrieve the 
module name. 

99999999 

In MFT (with subtasking) an 
ATTACH was issued, but the module 
requested did not receive 
control. 



**IRB**« 

indicates the SVC was issued by 
an asychronously executed routine 
with an associated IRB. 
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OLTCB hhhhhhhh 

the address of the TCB that was 
current when the SVC was issued. 

In MVT-M65MP systems the OLA and OLB 
fields replace the OLTCE field and 
indicate the addresses of the TCBs 
that were current in CPU A and CPU B 
when the SVC was issued. 



R15/R0 hhhhhhhh hhhhhhhh Rl hhhhhhhh 
the contents of registers 15, f 
when the SVC was issued. 



and 1 



SVC Comprehensive Trace Records Group 1 
Basic Fields 



SVC 2 (POST) 

R15 contains no applicable 

information. 

RO contains the completion code to be 

placed in the ECB. 

Rl contains the address of the ECB to 

be posted. 
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SVC 3 (EXIT) 



registers contain no applicable 
information. 



svc 10 (regmain: 

R15 contains no applicable 
information. 

R0 contains the number of the subpool 
requested in the high order byte, and 
the number of bytes requested in the 
low order three bytes. 
Rl contains any negative value if the 
request is for a GETMAIN; contains the 
address of the storage to be freed if 
the request is for a FREEMAIN; 
contains zero value if the request is 
for a FREEMAIN for an entire subpool. 

SVC 11 (TIME) 

R15 contains no applicable 

information. 

R0 contains no applicable information. 

Rl contains flag bits in the low order 

byte that designate how the time is to 

be returned in Register 0. 

If the low order byte is: 



x'00 1 



register is to contain a 
32 bit unsigned binary 
number representing the 
number of timer units that 
have elapsed. (A timer unit 
is 26. 04 micro-seconds). 



x'Ol* 



x B 02' 



register is to contain 
elapsed time in hundredths 
of a second. 



register is to contain 
packed decimal digits 
representing elapsed time in 
hours, minutes, seconds, 
tenths of a second, and 
hundredths of a second 
(HHMMSSth). 



SVC 12 (SYNCH) 



R15 contains the address of the entry 
point for the processing program that 
is to be given control. 
R0 contains no applicable information. 
Rl contains no applicable information. 



SVC 34 (MGCR) 



R15 contains no applicable 
information. 

R0 and Rl contents are as follows: 
Rl, if positive, contains a 
pointer to the command buffer of 
the command to be processed. R0 
is not used in this case. 



If Rl is negative and R0 is zero, 
then Rl contains a pointer to the 
CSCB that is to be either added 
to the chain or deleted from the 
chain. 

If Rl is negative and R0 is 
positive, then Rl contains a 
pointer to the CIB that is to be 
added to or deleted from the 
chain. R0 contains a pointer to 
the beginning of the chain. 

If Rl is negative and R0 is 
negative, then R0 contains a 
pointer to the CIB in which the 
CIB count is to be set and Rl 
contains the value to which the 
CIB count is to be set. 

SVC 36 (WTL) 

R15 contains no applicable information. 
R0 contains no applicable information. 
Rl if positive, contains a pointer to 
the user record that is to be written to 
the system log dataset. 

If negative, contains a pointer to 
the LCA indicating either 
initialization, (both data sets 
have to be opened) , or data set 
switching is required. 

SVC 38 (TTROUTER) 

Registers 15, 0, and 1 do not contain 
any applicable information. 

SVC 43 (CIRB) 

R15 contains no applicable 
information. 

R0 contains the entry point address of 
the user's asynchronous exit routine. 
Rl contains option bit flags in the 
high order ha If word and the size of 
the work area requested (in double 
words) in the low order half word. 

Flag settings are: 

flag byte 1 

1 DIRB 

CIRB 

.1000... bits 1-4 always set 

as shown 
..... 1. . problem program key 
.....0.. supervisor key 

1. problem program state 

......0. supervisor state 

1 save area for 

registers requested 
no save area 

requested 

flag byte 2 

xxxx . . xx res erVed 

....1... do not return IQEs at 

exit 
1.. return IQEs at exit 
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SVC »6 (TTIMER) 

R15 contains no applicable 

information. 

RO contains no applicable information. 

Rl the low order three bytes carry 

code determining how TTIMER should 

work, as follows: 



x'00' 



x'Ol' 



the time remaining in the 
current tasks time interval 
is to be returned in 
register 0; the interval 
timer is not to be canceled. 



the current task's time 
interval is to be canceled. 



SVC 61 (TSAV) 

Registers 15 and have no applicable 
information. 

Rl contains zeroes if the routine is 
being entered from the Overlay 
Supervisor. 

Rl contains the address of the DCB 
used to fetch the module (set to a 
negative value) if the routine is 
being entered from the Contents 
Supervisor. 

SVC 68 (SYNADAF/SYNADRLS) 



x , 02 i 



the time interval of a 
related task is to be 
canceled. 



SVC H9 (TTOPEN) 

Registers 15, 0, and 1 do not contain 
any applicable information. 



SVC 52 (Restart/SMB Reader). 

Registers 15 and have no applicable 
information. 

Rl contents are as follows: 

If SVC 52 is issued by the 
Initiator for the purpose of 
reading SMBs (containing JCL) for 
an automatic step or checkpoint 
restart, register 1 points to a 
job queue DCB, SMB buffer, and 
general work space. 

If SVC 52 is issued from module 
IEFRSTRT to initiate a check 
point restart, register 1 
contains a pointer to a parameter 
list. 

SVC 59 (OLTEP) 



R15 contains no applicable 

information. 

RO contains a pointer to a three word 

parameter list, which, in turn 

contains pointers as follows: 

Word 1 — pointer to UCB 
Word 2 — pointer to DEB 
Word 3 — pointer to IECIOLTS 
(I/O interrupt handler) . 
Rl contains a call code used to 
locate the particular OLTEP function 
requested. The value will be greater 
than x'OO* and equal or less than 
x*9«t , . 



Entry from SYNADAF : 

R15 contains a flag byte in the 
high-order position and three bytes of 
user data or an address of an entry 
point to the SYNAD routine. 

The flag byte contains codes as 
follows: 

00 EXCP request 

01 BPAM request 

02 BSAM request 

03 QSAM request 

04 BDAM request 

05 BISAM request 

06 QISAM request 

07 BTAM request 

08 QTAM request 

09 GAM request 

R0 contains, in the three low order 
bytes, the address of the DECB (BSAM, 
BPAM, BDAM) or the address of the IOB 
(BISAM, QISAM, QSAM). 

Additionally, when a QSAM request is 
made, the high-order byte contains the 
offset of the first CCW in the IOB. 

Rl contains a flag byte and the 
address of the DCB in the high-order 
byte and the three low-order bytes 
respective ly. 

The flag byte bit settings are: 



00000000 


BISAM and QISAM 


1 


error caused by input 


.1 


error caused by 




output 


..1 


error caused by BSP, 




CNTRL, or POINT 


...1 


record had been 




successfully read 


....1... 


INVALID request 


.....1.. 


PT conversion - 




invalid character 




BDAM only - hardware 




error 




BDAM only - no space 




for record 
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Entry from SYNADRLS : 

Registers and 1 have no applicable 

information. 

R15 contains x'FF* in the high-order 
byte, indicating the SVC routine is 
being entered from the SYNADRLS macro 
instruction and three bytes of user 
data. 

SVC 7 2 (CHATR) 

Registers 15 and have no applicable 
information. 

Rl contains the address of a parameter 
list with the following structure: 



5 non-dispatchable - TCB address 

6 stop non-dispatchable 

7 start dispatchable 

Rl the high-order bit indicates SET or 
RESET: 

SET(SS) 

1 RESET (RS) 

The three low-order bytes contain 
the TCB address if it was 
specified, or, if not, zero. 



SVC 8 3 (SMFWTM) 



offset 



4 

8 

16 



20 

2d 



address of parameter list+8 

address of DCB 

module name for XCTL 

code for OPEN/ CLOSE (1 byte); 

address of UCM entry (3 

bytes) 

address of UCM 

address of return 



SVC 76 (IFBSTAT) 

R15 contains no applicable 
information. 

The content and applicability of 
Registers and 1 vary with the 
presence or absence of RDE 
(Reliability Data Extractor) routines 
in the control program. 

If RDE is present: 

R0 contains a positive or 8. 
Rl has no applicable information. 

A positive in R0 indicates that 
EOD recording is requested; a 
positive 8 indicates that 1PL 
recording is requested. 

If RDE is not present: 

R0 contains a negative number 
representing the length in bytes 
of a record to be placed in the 
SYSl.LOGREC data set. 
Rl contains the address of the 
record to be written. 

SVC 79 (STATUS) 

R15 has no applicable information. 

R0 If ND was specified, the two 
high- order bytes contain the bits 
indicating dispatchability. 

The two low-order bytes contain 

the function code: 

cannot be rolled out 

1 must complete - step 

2 must complete - system 

3 non-dispatchable - step 

4 non-dispatchable - system 



Registers 15 and contain no 
applicable information. 

Rl contains a pointer as follows: 
If positive a pointer to the 
record that is to be written to 
the SMF data set. 

if negative a pointer to the SMCA 
indicating either initialization 
or processing for a SWITCH 
command to switch SMF data sets. 

SVC 84 (Restart Address Routine) 

SVC 84 is issued by the GPS Graphic 
I/O Control Routine to have the buffer 
restart address stored in the UCB 
associated with the display unit for 
which the routine builds a channel 
program. 

R15 contains no applicable 
information. 

R0 contains the buffer restart address 
to be stored in the UCB in the high 
order two bytes. The low order two 
bytes point to the UCB. 
Rl contains a zero 

SVC 85 (SWAP) 



Registers 15, 0, and 1 do not contain 
any applicable information. 

SVC 91 (VOLSTAT) 

R15 contains no applicable 

information. 

R0 when negative, contains the address 

of the UCB. Note: If device type is 

disk go to SVC 91 load 2. 

R0 when positive, contains the address 

of the DCB. 

Rl contents are as follows: 

if zero, the SVC was issued by CLOSE 
if X'32V, the SVC was issued by DDR 
if X'33' the SVC was issued by EOD 
if X w 63*v the SVC was issued by EOV 
if any other than the above, the SVC 
was issued by UNALLOCATION 

SVC 92 (TCBEXCP) 



R15 contains no applicable information 
R0 contains the address of the TCB for 
the issuers task. 
Rl contains the address of the IOB. 
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SVC 9 3 (TGET/TPUT) 



Entry from TGET 

R15 contains no applicable information 

RO the two high-order bytes are 
reserved. The two low-order bytes 
contain the buffer size in bytes. 

Rl contains a flag byte and an address 
as follows : 

the high order byte is a flag byte 

with these bit settings. 

1 Denotes "TGET" 

specified 

Denotes "TPUT" 

specified 
. 1...... Reserved. 

..1..... Reserved for TPUT 

...1.... Denotes "NOWAIT" 

specified means that 
control should be 
returned to the 
program that issued 
the TGET whether or 
not an input line is 
available from the 
terminal if no input 
line is obtained, a 
return code of 4 will 
be found in register 
15. 
...0.-.. Denotes "WAIT" 

specified means that 
control will not be 
returned to the 
program that issued 
the TGET until an 
input line has been 
put into the 
program's buffer if 
an input line is not 
available from the 
terminal, the issuing 
program is put into a 
wait state until a 
line does become 
available and is 
placed in the 
program's buffer 
....1... Reserved for TPUT 

..... 1. . Reserved for TPUT 

...... 10 Reserved for TPUT 

01 Denotes "ASIS" 

specified means that 
normal or minimal 
editing will be 
performed. 
......00 Denotes "EDIT" 

specified means that 
in addition to the 
normal ("ASIS") 
editing, further 
editing will be 
performed. 



the low-order three bytes contain the 
address of the buffer that is to 
receive the input line. 

Entry from TPUT 

R15 contains no applicable 
information. 

R0 the two high-order bytes contain 
the Terminal Job Identifier number; 
the two low-order bytes contain the 
size of the input buffer in bytes. 

Rl contains a flag byte and an address 
as follows: 

the high-order byte is a flag 
byte with these bit settings: 

1 Denotes "TGET" 

specified 

Denotes "TPUT" 

specified 

.1 Reserved 

..1 Denotes "LOWP" 

specified means that 
the terminal will not 
receive any 
inter-terminal 
messages if TSBITOFF 
is on even if a 
key-zero task is 
sending the messages 
may only be specified 
on a TPUT with TJID. 

..0 Denotes "HIGHP" 

specified means that 
the terminal will 
receive 

inter-terminal 
messages even if 
TSBITOFF is on if a 
key- zero task is 
sending the messages 
may only be specified 
on a TPUT with TJID. 
...1.... Denotes "NOWAIT" 

specified means that 
control should be 
returned to the 
program that issued 
the TPUT whether or 
not system output 
buffers are available 
for the output line 
if no buffers are 
available, a return 
code of 4 will be 
found in register 15. 
...0.... Denotes "WAIT" 

specified means that 
control will not be 
returned to the 
program that issued 
the TPUT until the 
output line has oeen 
placed in a system 
output buffer if no 
buffers are 
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available, the 
issuing program will 
be put into a wait 
state until buffers 
do become available 
and the output line 
is placed in them. 

• . . 1. . . Denotes "HOLD** 

specified means that 
the program that 
issued the TPUT 
cannot continue its 
processing until this 
output line has been 
either written to the 
terminal or deleted. 

-..0... Denotes "NOHOLD" 

specified means that 
control should be 
returned to the 
program that issued 
the TPUT as soon as 
the output line has 
been placed on the 
output queue. 

.... 1. . Denotes "BREAKIN" 

specified means that 
output has precedence 
over input; that is, 
if the user at the 
terminal is 
transmitting, he is 
interrupted, and • this 
output line is sent 
any data that was 
received before the 
interruption is kept 
and displayed at the 
terminal following 
this output line. 

0.. Denotes "NOBREAK" 

specified means that 
input has precedence 
over output; that is, 
the output message 
will be placed on the 
output queue to be 
printed at some 
future time when the 
terminal user is not 
entering a line. 

10 Denotes "CONTROL" 

specified means that 
this line is composed 
of terminal control 
characters and will 
not print or move the 
carriage on the 
terminal. 

...... 01 Denotes "ASIS" 

specified; means that 
normal or minimal 
editing will be 
performed. 

...... 00 Denotes "EDIT" 

specified; means that 
in addition to the 
normal ("ASIS") 



editing, further 
editing will be 
performed. 

the low-order three bytes contain the 
address of the buffer that is to hold 
the line of output. 

SVC 94 (TERMCTL) 

Entry from TCLEARQ ; 

R15 contains no applicable 
information. 

R0 Contents: 



Bytes 



1-3 

Rl Contents! 

Bytes 





01 — Entry code 
— Reserved 



80 — "INPUT" specified 
00 — "OUTPUT" specified 
— Reserved 



1-3 

Entry from ST BREAK : 

R15 contains no applicable 
information. 



R0 Contents: 






Bytes 



1-3 


04 



— Entry code 

— Reserved 


Rl Contents: 






Bytes 



1-3 


80 

00 




— "YES* specified 

— "NO" specified 

— Reserved 


Entry from STCOM: 







R15 contains no applicable 
information. 



R0 Contents: 






Bytes 



1-3 


05 



— Entry code 

— Reserved 


Rl Contents: 






Bytes 


1-3 


80 

00 




— YES specified 

— NO specified 

— Reserved 


Entry from STTIMEOU: 



R15 contains no applicable 
information. 
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RO Contents: 






Bytes 



1-3 


06 — 
— 


Entry code 
Reserved 


Rl Contents: 






Bytes 


1-3 


80 — 
00 — 

— 


"YES" specified 
"NO" specified 
Reserved 


Entry from STCC: 





R15 contains no applicable 
information. 



RO Contents: 




Bytes 

07 — 

1-3 — 


Entry code 
Reserved 


Rl Contents: 




Bytes 

Flag ] 


byte as foi; 



1 first operand 

specified 
.1...... ATTN specified 

..1. .... LD specified 

...1.... CD specified 

00000000 no operands 
specified, 
retain 

previousl y-used 
characters. 
— Reserved 
hh — line delete control 
character. The 
hexadecimal 
representation of any 
EBCDIC character on the 
terminal keyboard except 
the new line (NL) and 
carriage return (CR) 
control characters, 
c — the character 
representation of any 
EBCDIC character on the 
terminal keyboard, 
hh — character delete 
control character. The 
hexadecimal 
representation of any 
EBCDIC character on the 
terminal keyboard except 
the new line (NL) and 
carriage return (CR) 
characters. 

c — the character 
representation of any 
EBCDIC character on the 
terminal keyboard. 



Entry from ST ATTN: 

R15 contains no applicable 
information. 

R0 Contents: 



Bytes 

1 
2 



Rl Contents: 
Bytes 



08 — Entry code 
00 — Reserved 
hh — Lines byte. The 
number of consecutive 
lines of output that can 
be directed to the 
terminal before the 
keyboard will unlock. 
00 — Output line 
counting is not used, 
hh — Tens byte* The 
tens of seconds that can 
elapse before the 
keyboard will unlock. 
00 — Locked keyboard 
timing is not used. 



Flag byte as follows: 

1.. LINES specified 

.1 TENS specified 






1-3 



input address 
specified 

00000000 no operands 
specified, 
results in a 
NOP instruction, 

hhhhhh — Character 

string address. 

000000 — no character 

string was specified. 



Entry from STAUTOLN : 

R15 contains no applicable informtion. 

R0 Contents 



Bytes 



1-3 



Rl Contents: 

Bytes 



1-3 



09 — Entry code 
hhhhhh — the address of 
a fullword containing the 
number to be assigned to 
the first line of 
terminal input. 



00 — Reserved 
hhhhhh — the address of 
a fullword containing the 
increment value used in 
assigning line numbers. 
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Entry from STSIZE : 



RO Contents: 



R15 contains no applicable 
information. 



Bytes 



1-3 



00 — Entry code 
— Reserved 



RO Contents s 

Bytes 


1.2 
3 



Rl Contents: 



0A — Entry code 

0000 — Reserved. 

hh — lines byte. The 

number of lines (depth) 

that can appear on the 

screen. 



000000 — Reserved 
hh — size byte. The 
logical line size (width) 
in characters of the 
terminal. 



Entry from GTSIZE, STAUTOCP, SPAUTOPT, 
RTAUTOPT 



Bytes 

0-2 

3 



R15 contains no applicable 
information. 



R0 Contents: 

Bytes 




1-3 



Entry codes as follows: 

0B — GTSIZE 
0C — STAUTOCP 
0D — SPAUTOPT 
0E — RTAUTOPT 
000000 — Reserved 



Rl Contents: 

No applicable information, will 
be zeroed. 

Entry from STCLEAR : 

R15 contains no applicable 
information. 

R0 Contents: 



Bytes 



1-3 

Rl Contents: 

Bytes 



1*3 



10 — Entry code 
000000 — Reserved 



00 — Reserved, 
hhhhhh -- erasure 
character string address. 



Entry from TCABEND 

R15 contains no applicable 
information. 



Rl Contents: 

No applicable information will be 
zeroed. 

Entry from TS ABEND 

R15 contains no applicable 
information. 

R0 Contents: 



Bytes 



1-3 



OF — Entry code 
— Reserved 



Rl Contents: 

No applicable information will be 
zeroed. 



SVC 95 (TSIP) 



R15 contains no applicable 
information. 



R0 Contents: 

Bytes 
0,1 



2 
3 

Entry Code 
00 

01 



zero or Terminal Job 

Identifier (TJID) or not 

applicable. 

00 — Reserved 

Entry code as follows: 

Calling Routine 
Problem Program (TMP) 

Timer Second - Level 
Interruption Handler 



02 


TGET/TPUT 


03 


Region Control Task 


04 


Dequeue, TIOC (Attention, 
TS INPUT, TSOUTPUT), Timer 
SLIH, WTOR 


05 


Region Control Task 


06 


Enqueue 


07 


Dequeue 


08 


TSO Dispatcher 


09 


TSO Dispatcher 


0A 


TSO Dispatcher 


0B 


TSO Dispatcher 


0C 


Region Control Task (Quiesce) 
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OD 
OE 

OF 

10 

11 

12 

13 

14-18 



Region Control Task (Quiesce) 

Time Sharing Control Task 
(Swap) 

Time Sharing Control Task 
(Swap) 

Time Sharing Control Task 
(Swap) 

Time Sharing Control Task 
(Swap) 

Region Control Task (Restore) 

Region Control Task (Restore) 

Reserved 



Rl Contents: 

B ytes 

0,1,2,3 variable as follows: 

Entry Code Content 

00 Address of 8- character 
command name sign- bit: 

0-ended 
1-beginning 

01 not applicable 

2 Sign-bit: 
0- Input 
1-Output 

Bytes 364: 

Number of free buffers 

03-0 5 not applicable 

6 Estimated must complete time 

07-OC not applicable 

0D Number of FBQEs 

0E Byte 0: Swap Units 

Byte 1: Swap device code 
(0,4,8,c) 

Bytes 263: 

Swap size in 2K blocks 

OF- 13 not applicable 

SVC 9 7 (TEST (TCP)) 

Entered from* 

Any module of the tested program, 
when used as a breakpoint 
handler, if used as a breakpoint 
handler the TCBTCP bit is '!• in 
the current TCB and registers 15, 
0, and 1 contain no applicable 
information. 



Any module of the TSO Test 
Command Processor when used as a 
subroutine of TSO TEST. In this 
case the current TCBTCP bit is 
'0* and registers are as follows: 

R15 contains no applicable 
information. 

R0 Contents: 

Bytes 

Entry code as follows: 
40 — Set TCBTCP bit to 
•1' 

20 ~ Set TCBTCP bit to 
'0' 

10 — Alter TCBTRN field 
08 — Alter second word 
of RBOPSW field 
04 — Alter specific 
register in SVC 97' s SVRB 
register save area 
04 — Alter all registers 
in SVC 97 *s SVRB register 
save area 
02 — Alter 

floating-point register 
in TCB save area 
01 — Set RB wait count 
to (zero) . 
1-3 Address of target TCB, 
PRB, or IRB 
Rl Contents: 

Register 1 contents are variable as 
follows: 

Bytes 
Entry code 0123 not applicable 

40 
entry code 0123 not applicable 

20 
entry code not applicable 

1,2,3 TCBTRN value 
entry code instruction length, 
08 completion code 

program mask 
08 

1,2,3 address of value for 
second word of 
RBOPSW field, 
entry code register number 

07 1,2,3 address of new value 
entry code x'FF* 

04 1,2,3 address of 64-byte 
value 
entry code floating-point 
02 1,2,3 register number 

address of new value 
for register 
entry code 0,1, not applicable 

01 2,3 

SVC 100 

SVC 100 is used by the SUBMIT, OUTPUT, 
OPERATOR, and CANCEL/ STATUS 
processors . 
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Contact your FE programming 
representative for information 
concerning the content of General 
Purpose Registers 15, 0, and 1 upon 
entry to SVC 100. 



SVC 101 (QTIP) 



SVC 101 is used only by the TSO 
sub-system and the MCP and provides an 
interface between them for 
inter-region communication and data 
movement. 

R15 Contents: 

Bytes 

— zeroed, by entry 

code in R0 
1-3 hhhhhh — variable by 

entry code in R0 as 

follows: 

00 — not applicable 
03 — entry address of 
QTIP0030 within 
IEDAYAA 
04-0D — not applicable 
0E — (with savearea 
address in Rl) not 
applicable. (Without 
savearea address in 
Rl) entry address .of 
QTIP014 within 
IEDAYOO 
0F-11 — not applicable 
12-16 — entry address of 
IKJGGQT1, branch entry to 
QTIP SVC 

17 — address of TSB 
being logged off 

18 — (same as 12-16) 
19- 1A — not applicable 

1C — entry address of 

QTIP0280 within 

IEDAYII 

ID — not applicable. 



R0 Content: 










Bytes 













— 2 


:eroed. 




1-3 


hh — 


entry codes as 




follows 








00 


— 


invokes 


IEDAYAA 




03 


— 


invokes 


IEDAYAA 




04 


— 


invokes 


IEDAYHH 




05-09 


— 


invokes 


IEDAYII; 




0A 


— 


invokes 


IEDAYLL; 




0B-11 


— 


invokes 


IEDAYOO 




12-14 


— 


invokes 


IEDAYGP 




15-16 


— 


invokes 


IEDAYAA; 




17 


— 


invokes 


IKJGG088 




18 


— 


invokes 


IEDAYOO; 




19-1A 


— 


IEDAYZZ 


invoked 




1C 


— 


invokes 


IEDAYII 




ID 


— 


IEDAYGP 


invoked; 



Rl Content: 



Bytes 



1-3 



— zeroed. 

hhhhhh — variable by 

entry code in R0 as 

follows: 



00 — address of 
savearea within AVT 
03 — not applicable 
04-0D — address of 
savearea within AVT 
0E — (without entry 
address in R15; 
address of savearea in 
AVT) (with entry 
address in R15; not 
applicable) 
0F-11 — address of 
savearea within AVT 
12-16 — not applicable 

17 — zeroed; 
indicates no savearea 
is being passed 

18 — not applicable 
19-1 A — address of 
savearea within AVT 

1C — not applicable 
ID — address of 
savearea within 
TIOCRPT 



SVC 103 (XLATE) 

R15 contains no applicable 
information. 

R0 contains the length of the field to 
be translated. 

Rl Contents: 

Bytes 







1-3 



SVC 104 (TCAM) 



hh action byte as 
follows : 

80-translate from 
EBCIDIC to ASCII 
00-translate from 
ASCII to EBCDIC 

hhhhhh address of field to 
be translated 



R15 contains no applicable information 

R0 indicates the subroutine to be 
executed as follows: 
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Bytes 

0-3 00000001 IGC0010D entry 
point routine 

00000002 GTFIELDA decode 
routine 

00000003 STTNME operator 
command addressing 
routine 

00000004 IEDQCA02 scan 
routine 

Rl contains the address of the 
operator control work area 



SVC 105 (IMGLIB) 

R15 contains no applicable information 

R0 contains no applicable information 

Rl indicates actions to be taken as 
follows : 

Bytes 

0-3 00000000 construct a DCB 
and DEB for 
SYS1. IMGLIB 
hhhhhhhh delete DCB at this 
address and also 
the DEB pointed to 
by the DCB. 



SVC 109 



Type 3 and type U SVC routing routine. 

R15 contains an index value, converted 
to 3 digit EBCDIC number and appended 
to name IGC00. This routine is then 
called. 

R0/R1 contain no applicable 
information for SVC 109, contents are 
to be used by called routine IGX00. 



SVC 116 



Type 1 SVC routing routine. 

R15 contains an index value, used in 
binary form to index into a table to 
call other SVC routines. 

R0/R1 contain no applicable 
information for SVC 116, contents are 
to be used by called routines. 



SVC 117 



Type 2 SVC routing routine. 

R15 contains an index value, used in 
binary form to index into a table to 
call other SVC routines. 

R0/R1 contain no applicable 
information for SVC 117, contents are 
to be used by called routines. 
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SVC Comprehensive Trace Records Group 2 - 
Basic Fields Plus DDNAME Field 



Group 2 SVC comprehensive trace records add 
a DDNAME field to the fields composing the 
basic record. The format is: 

!********^ 
cccccccc) 
N/A J 

******** 

asterisks indicate an error 
occurred while gathering the 
information. 

cccccccc 

the name of the associated DD 
statement . 

N/A 

indicates that the DD name could 
not be obtained for the following 
reasons : 

The DCB was not opened 

The DCB TIOT offset was outside 

the valid range 

The DEB TCB pointer was set to 

The TCB TIOT pointer was set to 



The DD name in the TIOT was not 

in EBCDIC notation 

Following are descriptions of register 15, 
0, and 1 content for the Group 2 SVCs. 

SVC 24 (DEVTYPE) 

R15 contains no applicable 
information. 

R0 contains the address of the output 
area or the two's compliment of the 
output area address. 

Rl contains the address of the DD 
name, or the two's compliment of the 
DD name address. 

When control returns from the DEVTYPE 
SVC routine, the output area will 
contain 8, 20, or 24 bytes of device 
data, depending on the value (+ or -) 
of R0 and Rl, and the device type 
associated with the DDNAME as follows. 



SVC 31 (FEOV) 



R0 and Rl 

positive 

R0 negative 

and 

Rl positive 

R0 and Rl 

negative 



Output Area Size (Bytes) 
BPS- DA DA Non-DA 



20 



20 



2U 



20 



20 



20 



R15 and R0 contain no applicable 
information 



Rl contains the address of the DCB 



SVC 53 (RELEX) 



R15 contains no applicable information 



R0 contains the address of a parameter 
list which contains either: 



hhhhhhhh relative block or TTR 
MBBCCHHR actual address 



Rl contains the address of the DCB 

SVC 55 (EOV) 

R15 contains no applicable information 

R0 contains the IOB address if the 
following are true: 

DCBOFLAGS = . . . 1 

DCBMACRF = 

and R0 is not equal to x' 00001000' 

Rl contains the DCB address 

SVC 57 (FREEDBUF) 

R15 contains no applicable information 
R0 contains the address of the DECB 
Rl contains the address of the DCB 

SVC 58 (REQBUF/RELBUF) 

R15 contains no applicable information 

R0 contains the request count or 
release address 

Rl contains the DCB address 

SVC 69 (BSP) 

R15 and R0 contain no applicable 
information 

Rl contains the address of the DCB 



Section 3: Tracing Aids 181 



SVC Comprehensive Trace Records; Group 3 - 
Basic Fields Plus Parameter List Field 



Group 3 SVC comprehensive trace records add 
a parameter list field to the fields 
composing the basic record. The parameter 
list field displays all or a portion of the 
parameter list being passed to the SVC 
routine by the caller. The format is: 



{N/A 
hhhhhhhh hhhhhhhh hhhhhhhh 
******** ******** ******** 



N/A 



indicates that there is no 
applicable information 



hhhhhhhh hhhhhhhh ... 

parameter list display. Content 
and amount varies with the SVC 
being traced. 

******** ******** 

indicates that an error occurred 
while gathering the information. 

Following are descriptions of register 15, 
0, and 1 content, and PLIST content for the 
Group 3 SVCs. 

SVC 1 (WAIT) 

R15 contains no applicable information 

R0 contains the count of the events 
being waited on. If zero the wait is 
treated as a NOP. 

Rl if positive, contains the address 
of the ECB being waited on. If 
negative, contains the address of a 
list of ECBs, in two's complement 

form. 

PLIST may contain up to 40 bytes of 
information. It consists of a list of 
ECB addresses up to a maximum of 10. 

SVC 4 (G ETMAIN) 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list piassedl Wh£h the SVC Was 
called. (If fci is 26 to" there is no 
parameter list clhd the PLlsT field 

will not be presSeht*) 

t»ltXti¥ iw t»n teyfe«» in length and 
breaks down as follows: 

Bytes 

0-3 hhhhhhhh 



a. 



b. 



For a single area 
request - the length 
requested. 

For a variable request 
- the address of a 
doubleword containing 
the minimum and 
maximum length 
requested as shown 
below: 



Bytes 


1,2,3 

a 

5,6,7 



zero 

minimum length 

zero 

maximum length 



For a list request - 
the address of a list 
of GETMAIN length 
requests (1 word per 
request) the last word 
containing x*80* in 
byte 0. 



hh 



Hierarchy identifier 
(optional) 

5-7 hhhhhhhh 

a. For a single area 
request - the address 
of a word GETMAIN will 
initialize as the 
beginning allocated 
core area. 

b. For a variable area 
request - the address 
of a doubleword which 
GETMAIN will 
initialize with the 
address of the 
GETMAINed area and the 
actual length 
allocated. 

c. For a list area 
request - the address 
of a list of words 
which GETMAIN will 
initialize with the 
address of allocated 
areas . 

8 hh Flag byte as follows: 

00 unconditional single area 

request 
20 conditional single area 

request 
CO unconditional variable 

request 
E0 conditional variable 

request 
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4-7 



80 unconditional list request 
A0 conditional list request 

9 hh Subpool identification 

SVC 5 (FREEMAIN) 

R15 and R0 contains no applicable 
information. 

Rl contains the address of the 
parameter list passed when the SVC was 
called. (If Rl is zero, no list 
passed, and PLIST will not appear.) 

PLIST is 10 bytes in length and breaks 
down as follows: 

Bytes 

0-3 a. For a single area request 
the length to be freed. 

b. For a list area request — 
the address of a list of 
FREEMAIN length requests 
(1 word per request), the 
list word containing x'SO* 
in byte 0. 

a. For a single area request 
— the address of an area 
to be freed. 

b. For a list area request — 
the address of a list of 
addresses of the areas to 
be freed. 

Flag byte as follows: 

00 unconditional single area 

request 
20 conditional single area 

request 
80 unconditional list area 

request 
A0 conditional list area 

request 
9 hh Subpool identification. 

SVC 18 (BLDL/FIND - Type D) 

R15 contains no applicable 
information. 

R0 contains the address of the 
parameter list. 

Rl contains the address of the OCB and 
indicates the macro instruction that 
issued the SVC call; if Rl is positive 
— BLDL; if Rl is negative — FIND. 

PLIST 

The BLDL parameter list is 12 
bytes in length: 

B^tes 

0,1 the numbering entries 

2,3 entry length 



8 hh 



4-11 the hexadecimal representation 
of the member name for which 
the BLDL was issued. 



The FIND parameter list is 8 
bytes in length: 



Bytes 
0-7 



the hexadecimal representation 
of the member name for which 
the FIND was issued. 



SVC 19.20. 22. 23 (OPEN.CLOSE.OPENJ.TCLOSE) 

R15 and R0 contain no applicable data*. 

Rl contains the address of the 
parameter list. 

PLIST is up to 40 bytes in length and 
consists of a series of 4-byte entries 
(up to 10). Each entry breaks down as 
follows : 



Bytes 











hh 




Option byte as shown 
below: 




Bits 








Last Entry indicator 




.011 


• • • • 


LEAVE 




.001 


.... 


REREAD 




.100 


.... 


REWIND 




.010 


• * * • 


IDLE 




.000 


.... 


DISP 




... 


0000 


INPUT 




> • • ■ 


1111 


OUTPUT 




• • ■ ■ 


0011 


INOUT 




. . . . 


0111 


OUTIN 




. • . • 


0100 


UPDAT 







0001 


RDBACK 


1-3 1 


ihhhhh 


DCB address 


SVC 35 (WTCv 


'WTOR) 





R15 contains no applicable 
information. 

R0 contains console source ID. 

Rl contains the address of the 
parameter list being passed to the 
SVC. 

PLIST is 12 bytes in length for WTO 
and 20 bytes in length for WTOR. 

The PLIST field for WTO breaks down as 
follows: 



Bytes 




00 — indicates WTO 
parameter list. 
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1 hh— • message length plus 

four, 
2„3 hhhh — MCS flag bytes? bit 
settings as follows: 

Byte 2 



Rl contains the address of the 
parameter list. 

PLIST is 12 bytes in length and breaks 
down as follows: 



• * x* • 



1....... Invalid entry 

.1. ...... Message is to be 

queued to the console 
whose source ID is 
passed in Register 0. 
the WTO is an 
immediate command 
response. 

. . . . 1. . , the WTO macro 

instruction is a reply 
to a WTOR macro 
instruction. 

. ....1. Message should be 
broadcast to all 
active consoles. 

...... 1 Message queued for 

hard copy only. 

....... 1 Message queued 

unconditionally to the 
console whose source 
ID is passed in 
register 0. 

Byte 3 

1. ...... time is not appended 

to the message. 

.1111... Invalid entry 

« . • . . 1. . message is not queued 
for hard copy 

.11 invalid entry 



Bytes 

0-3 
4-7 



8 
9-11 

SVC 39 (LABEL) 



hhhhhhhh branch instruction 

(to SVC 45) 

hhhhhhhh address of 

Referred-to Symbol 

hh "to" segment number 

hhhhhh Previous caller or 



R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST is 20 bytes in length and breaks 
down as follows: 



4-11 



First eight bytes 
of message 



The PLIST field for WTOR breaks down 
as follows: 



Bytes 



1-3 

4-7 

8 
9 

10 , 11 

12-19 



hh — length of reply 

hhhhhh — address of 

reply buffer 

hhhhhhhh — address of 

reply ECB 

00 — zeroed 

hh— message length plus 

four 

hhhh — MCS flag bytes, 

see WTO PLIST 

first eight bytes of 

message^ 



Bytes 

0-2 

3 

4-7 

8-11 

12,13 

14 

15 

16-19 

SVC 40 (Extract) 



c00004 — REWIND option 
C00006 — UNLOAD option 
hh relative UCB in TIOT 
to use for mounting 
purposes. 

hhhhhhhh address of 8 
byte DDNAME for DD card 
that allocates devices 
for mounting tapes, 
hhhhhhhh — address of 
volume label set. 
hhhh— length of one 
volume label, 
hh — number of labels 
in volume label set 
hh — command byte of 
control CCW 
hhhhhhhh — address of 
the first 10 bytes of 
volume header label. 



SVC 37 (SEGLD/SEGWTl 

R15 contains no" aipJ?iiCabl# 
information. 

R0 if zero, entry was from SEGLD; 
non-zero indicates entry from SEGWT. 



R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST is J.2 bytes in length and breaks 
down as follows: 

Bytes 






•_ 


Reserved 


1-3 


hhhhhh 


address of list area i 
which the extracted 
information will be 
stored. 


4 


00 


Reserved 
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5-7 



(TOOOO 



hhhhhh 



hh 



EXTRACT will obtain 
information from the 
current TCB and/or its 
related control blocks, 
address of TCB from 
which EXTRACT is to get 
requested information, 
flags byte; indicates 
the fields to be 
extracted as follows: 



Bits 



1. ...... . address of the 

general register 

save area 
.1 address of floating 

point register save 

area 
. .1. .... reserved 
.... 1. ... address of end-of - 

task exit routine 
. . . . 1. . . limit priority 6 

dispatching priority 
..... 1. . task completion code 

...... 1. address of TIOT 

....... 1 address of the 

command scheduler 

communication list 

in the CSCB 



hh TSO only flags byte; 
indicates the TSO 
fields to be extracted 
as follows! 



Bits 

1 address of time- 
sharing flags in TCB 

. 1 address of protected 

storage control 
block 

. . 1. .... terminal job 

identifier for task 

... xxxxx reserved 



10,11 0000 
SVC 45 (OVLYBRCH) 



reserved 



R15 contains the address of the Entry 
Table entry which caused the SVC to be 
issued. 

R0 and Rl contain no applicable 
information. 

PLIST is 12 bytes in length and breaks 
down as follows: 

0-3 hhhhhhhh Branch (inst. to 

SVC 45) 
4-7 hhhhhhhh address of 

Ref erred- to- Symbol 
8 hh "to" segment number 
9-11 hhhhhh Previous caller or 



SVC 47 (STIMER) 

R15 contains no applicable information 
R0 contents: 



Bytes 




hh 



1-3 



hhhhhh 



STIMER option byte 
as follows : 
x^O^ TOD option 
x^O 1 DINTVL option 
x'lO* BINTVL option 
x"00* TUINTVL option 
exit address 



R15 contains the address of the time 
value 

PLIST is four or eight bytes in length 
depending on the option in force: 

a. For the DINTVL and TOD options 
PLIST is eight bytes in length 
and represents the time value. 

b. For the BINTVL and TUNINTVL 
options PLIST is 4 bytes in 
length and represents the time 
value. 



SVC 4 8 (DEQ) 



R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST is 16 bytes in length and breaks 
down as follows: 



Bytes 

hh 



1 hh 



00 



2 hh 



if set to x'FF* 
indicates the last 
element in the 
parameter list. 
Otherwise no 
meaning. 

the length of the 
minor name whose 
address is in bytes 
8, 9, 10 and 11 of 
this element, 
the length of the 
minor name is in the 
first byte of the 
minor name field 
whose address is in 
bytes 8, 9, 10, and 
11 of this element 
(does not include 
length byte itself). 
DEQ parameters byte 
as follows : 

Bit Settings 

Exclusive request 

1 Shared request 

.0 MINOR name is known 

only to job step 
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. 1. . . - . .. the scope of minor 
name is SYSTEM 

..1..... Set must complete 
equal to SYSTEM 

. ..1. ... Set must complete 
equal to STEP 

.....000 RET=NONE 

001 RET=HAVE 

010 RET=CHNGE 

011 RET=USE 

Ill RET=TEST 

. ...1... RELEASE 
3 hh return code field 
for codes returned 
to the issuer by DEQ 
4-7 hhhhhhhh address of major 
resource name 
(QNAME) 
8-11 hhhhhhhh address of minor 
resource name 
(RNAME) 
12-15 hhhhhhhh if the DEQ 

parameters byte bit 
4 (RELEASE) is set 
on this word 
contains the UCB 
address ; otherwi se 
the content of this 
word is 
unpredictable. 



SVC 56 (ENQ) 



R15 and R0 contain no applicable 
information 



. ..... . MINOR name is known 

only to job step 

.1...... the scope of minor 

name is SYSTEM 

. .1..... set must complete 
equal to SYSTEM 

...1.... Set must complete 
equal to STEP 

000 RET=NONE 

001 RET=HAVE 

.....010 RET=CHNGE 

.....011 RET=USE 

Ill RET=TEST 

....1... RESERVE 
3 hh return code field 
for codes returned 
to the issuer by ENQ 
4-7 hhhhhhhh address of major 
resource name 
(QNAME) 
8-11 hhhhhhhh address of minor 
resource name 
(RNAME) 
12-15 hhhhhhhh if the ENQ 

parameters byte bit 
4 (RESERVE) is set 
on, this word 
contains the UCB 
address; otherwise 
the content of this 
word is 
unpredictable . 

SVC 60 (STAE/STAI) 



Rl contains the address of the 
parameter list 

PLIST is 16 bytes in length and breaks 
down as follows: 

Bytes 

hh if set to x^F' 

indicate the last 
element in the 
parameter list. 
Otherwise no 
meaning. 

1 hh the length of the 

minor name whose 
address is in bytes 
8, 9, 10, and 11 of 
this element. 
00 the length of the 

minor name is in the 
first byte of the 
minor name field 
whose address is in 
bytes '.,, 9, 10, and 
11 of this element 
(does not include 
length byte itself). 

2 hh ENQ parameters byte 

as follows: 

Bit Settings 

0. ..... . Exclusive request 

1. shared request 



R15 contains no applicable information 
R0 contents: 

00 — Create 

04 — Cancel 

08 — Overlay 

Rl contains the address of the 
parameter list. The high-order bit is 
set to one if the XCTL=YES parameter 
was coded. 

PLIST is eight bytes in length and 
breaks down as follows: 



Bytes 




1-3 



4-7 



flag byte as 

follows : 

x •80* for STAI 

process ing 

x • 20* for STAE 

process ing 

hhhhhh If zero, the 

* CAMCE:* operand is 
in effect; otherwise 
this is the address 
of the STAE/STAI 
exit routine. 

hhhhhhhh address of the exit 
routine parameter 
list; if zero no 
exit routine 
parameter list 
exists. 
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SVC 63 (CHKPT) 

R15 and RO contain no applicable info. 

Rl contents: 

a. the address of the parameter list 

b. Zero if a CANCEL request 

PL 1ST is eight bytes in length and 
breaks down as follows: 

Bytes 

00 check ID address 

provided via the second 
parameter of CHKPT 
macro instruction 
80 No check ID address 
provided 

1-3 hhhhhh address of checkpoint 
DCB 

4 00 check ID address not 
provided 
01 to lOcheck ID length 

provided via third 
parameter of the CHKPT 
macro instruction 
FF "S" specified as third 
parameter of CHKPT 
macro instruction; the 
system generated check 
ID is to be placed at 
the address specified 
in bytes 5-7 

5-7 hhhhhh address for storing 

system generated check 
ID or address of user 
provided check ID 

SVC 64 (RDJFCB) 

R15 and R0 contain no applicable 
information 

Rl contains the address of the 
parameter list 

PLIST is up to forty bytes in length 
and consists of a series of 4-byte 
entries containing the DCB address. 
The high-order byte has bit set to 
one to indicate the last entry. 

SVC 70 (GSERV) 

R15 and R0 contain no applicable 
information. 

Rl contents: 



PLIST is four bytes in length and 
displays the fullword pointed to by 
Rl. Byte is a unit index factor 
used to locate the UCB address in the 
DEB associated with the DCB. (The GCB 
to be reset is in the UCB). 



SVC 73 (SPAR) 



Bytes 




1-3 



hh is a mask indicating 
which bits in the 
Graphic Control Byve 
(GCB) should be reset. 

hhhhhh the address of a 

fullword field that 
identifies the DCB 
related to the GCB in 
which bits are to be 
reset. 



R15 and R0 contain no applicable 
information 

Rl contains the address of the 
parameter list 

PLIST is up to 40 bytes in length and 
consists of a series of 4-byte 
entries. The first entry breaks down 
as follows: 



Bytes 




hh 



the priority specified 
for the attention 
routine by the SPAR 
macro instruction. 
Reserved 

the number of words in 
the parameter list. 
Each additional entry contains a GACB 
address as specified by the SPAR 
macro. 



1 
2,3 



hh 
hhhh 



SVC 74 (DAR) 



R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST is up to forty bytes in length, 
consisting of 4-byte entries. The 
first entry breaks down as follows: 



Bytes 

0,1 

2,3 



hh Reserved 
hh the number of words in 
the parameter list. 



Each additional entry contains a GACB 
address specified by the DAR macro. 



SVC 77 (ONLT) 



R15 contains the address of the UCB of 
the line for the terminal being 
tested. 

R0 contains the address of the first 
of five * 9*s in the test request 
buffer for ONLT (five * 9's* indicate a 
request for an online test). 

Rl contains the address of the 
parameter list. 

PLIST is 14 bytes in length and breaks 
down as follows: 
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Bytes 






0-3 


hhhhhhhh 


address of the ECB 
and the prefix of the 
request buffer. 


4-7 


hhhhhhhh 


address of the 
GETMAIN parameters 
and terminal test 
pattern table. 


8-11 


hhhhhhhh 


address of special 
line control 
characters 


12 


hh 


00 means test is 
valid 

01 means test is 
invalid and not set 



13 



•hh 



up 

00 means no answer on 
dial line 

01 means answer on 
dial line 



SVC 80 CGJP/GFX) 



(The SVC 80 Processing Routine serves 
as a communication link between GJP 
routines and the GFX Task, and between 
the GFX task and ABEND Hook routine. ) 

R15 contains no applicable 
information. 



Rl If R0 is not negative, Rl contains 
a message ID word (which is also 
displayed in the PLIST field). 

If R0 is negative, Rl contains the 
address of a list of message ID words - 

PLIST is up to 40 bytes in length, 
consisting of 4-byte entries. Each 
entry is a message ID word. The last 
entry is identified by the bit in 
the high-order byte being set to 1. 

SVC 90 (XQMNGR) 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the QMPA. 

PLIST is 36 bytes in length and 
contains the QMPA fields. The QMPA 
and its associated control blocks are 
described in the MVT Job Management 
PLM, Order No. GY28-6660. 

SVC 96 (ST AX) 

R15 and R0 contain no applicable 
information. 



R0 contains the address of the 
parameter list. 

Rl contains the address of the console 
control table. 

PLIST is eight bytes in length and 
breaks down as follows: 



Bytes 

0-3 cccc 



indicates which 
routine passed to SVC 
80 as follows: 

PLOG — Log Off 

PBEG — Begin Job 

Processor 

ABDH — Abend Hook 

Routine 

IERR — Internal 

Error Routine 

NPRO -- Initial 

Processor 



Rl contains the address of the 
parameter list. 

PLIST is 20 bytes in length and breaks 
down as follows: 



Bytes 

0-3 hhhhhhhh 



4,5 hhhh 

6,7 hhhh 

8-11 hhhhhhhh 

12-15 hhhhhhhh 

16 hh 



address of user 

program to get 

control at attention 

interrupt. 

size of input buffer 

(max 4095) 

size of output 

buffer (max 4095) 

address of output 

buffer 

address of input 

buffer 

STAX option flag 

byte as follows: 

Bits 



4-7 hhhhhhhh the 2250 unit address 
that indicates which 
graphic job processor 
is using the SVC 80 
routine. 



SVC 87 (DOM) 



R15 contains no applicable 
information. 

R0 the value (positive or negative) of 
R0 determines the content of Rl. 



17-19 hhhhhh 



1 .Reserved 

...... repl ace=YES 

1 replace=NO 

.l.....defer=YES 

.. 1 defer=NO 

. . . llllReserved 

address of user 
parameters for user 
program. 
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SVC 99 (TSO Dynamic Allocation) 

R15 and RO contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST is up to 40 bytes in length. 
Consult your FE programming 
representative for information 
concerning the data displayed in this 
field. 

SVC 102 (TCAM) 

R15 and RO contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST is up to 12 bytes in length 
depending on the function and breaks 
down as follows : 



Bytes 

hh 



Action code byte for 
SVC 102 as follows: 

1. .. .... Flag issuing 

task not 
eligible for 
rollout 

.1.. .... Post rollout/ 

roll in ECB 
complete 

..1 Post standard 

or TSO ECB 
complete 

...1 .... Flag issuing 
task not 
eligible for 
swap 

.... 1. . . Move data 
across 
partition 
boundary 

1. . Enqueue 

element on 
disabled 
ready queue 
and post MCP 
ECB complete 

.... ..1. Flag issuing 

task eligible 
for swap 

.... ...1 Flag issuing 

task eligible 
for rollout 



1-3 hhhhhh varies by action code 
as follows : 

Action Code 

80,40,01 ECB address 

20,02,10 

08,04 Data Address 

4 hh varies by action code 
as follows: 

20 x^O 1 , last 
four bytes 

80,40,01, 

08,04,02, 

10 x'00* 

reserved 

5-7 hhhhhh varies by action code 
as follows: 

Action Code 

20,02,10 TSO job ID 

address 
80,40,01, TCB address 
08,04 Taraet 

address (for 
enqueuing an 
element the 
target 
address is 
the address 
of the 
disabled 
ready queue 
in the TCAM 
AVT). 

8 hh varies with action code 
as follows: 

Action Code 

80,40,20,10,08, 
04,02,01 x*80', last 
four bytes 

9-11 hhhhhh varies with action code 
as follows : 

Action Code 

80.40.01 DEB address 
08,04 Length 

address 

10.20.02 TCB address 
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SVC Comprehensive Trace Records; Group 4 - 
Basic Fields Plus Variable Fields 



GTF Group 1 SVC comprehensive trace records 
have a variety of fields — differing from 
SVC to SVC — added to the fields composing 
the basic SVC record (Group 1). Format and 
content of the additional fields for each 
SVC are discussed in the following 
material. 



1-3 hhhhhh If byte is 80; the 
address of the 
directory entry list. 



If byte is 00; the 
address of the entry 
point name. 

hh hierarchy ID as 
follows : 



SVC (EXCP) 



Additional fields — DDNAME, DCB, DEB. 

Register 15, 0, and 1 content, and 
DDNAME DCB, and DEB format and content 
follow: 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the IOB 
associated with this request. 

DDNAME cccccccc 
N/A 

See explanation of DDNAME field 
under Group 2. 

DCB hhhhhhhh 

address of the DCB associated with 
this I/O request. 

DEB hhhhhhhh 

address of the DEB associated with 
this I/O request. 



SVC 6 (LINK) 



Additional fields — PLIST, NAME 

Register 15, 0, and 1 content, and 
PLIST and NAME format and content 
follow: 

R15 contains the address of the 
parameter list. 

R0 and Rl contain no applicable 
information. 

PLIST hhhhhhhh hhhhhhhh 

is eight bytes in length and 
breaks down as follows: 



Bytes 
hh 



flag byte as follows: 

80 DE form of macro 

instruction 

00 EP and EPLOC form 

of macro instruction 



00 — no hierarchy 

01 — hierarchy 

02 — hierarchy 1 

5 hhhhhh address of DCB or 
zero. 

NAME cccccccc 

is the entry point/directory 
entry (EP/DE) name of the module 
to be linked to or control 
transferred to. 

SVC 7 (XCTL) 

(Same as SVC 6) 

SVC 8 (LOAD) 

Additional field — NAME 

R15 contains no applicable 
information. 

R0 Content: 

If byte contains x'OO', bytes 
1, 2, and 3 contain the address 
of the entry point name. 

If byte contains x'80', bytes 
1, 2, and 3 contain the address 
of the directory entry list. 



Rl Content: 

In LCS systems, byte contains 
the hierarchy ID as follows : 

00 — no hierarchy 

01 — hierarchy 

02 — hierarchy 1 

In systems without LCS byte 
contains no significant 
information. 

Bytes 1, 2, and 3 contain the DCB 
address or zero if the default 
for DCB was specified. 



NAME cccccccc 

is the entry point /directory 
entry name of the module to be 
loaded. 
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SVC 9 (Delete) 

Additional field — NAME 

R15 and Rl contain no applicable 
information. 

RO contains the address of the entry 
point name. 

NAME cccccccc 

is the entry point name of the 
module to be deleted. 

SVC 13 (ABEND) 

Additional field — CMP CODE 

R15 and RO contain no applicable 
information. 



Rl contains the address of the Request 
Queue Element (RQE) which was assigned 
to this I/O request by IOS. 

DDNAME CCCCCCCC 

is the name of the DD statement 
associated with this I/O request* 

RQE hhhhhhhh hhhhhhhh hhhhhhhh 

is the first 12 bytes of the RQE 
assigned to this request by IOS. 
The breakdown is : 



Bytes 

0,1 

2,3 



hhhh not applicable 
hhhh address of the UCB 
hh TCB ID for MFT 



5,6,7 hhhhhh address of IOB 



8 



hh 



priority byte 



hhhhhh address of DEB 



Rl contains significant information 
only if SVC 13 was not called by the 
ABTERM routines. In this case Rl 
contains the following: 



Bytes 
hh 



Flag byte as follows: 

Bits 

1 DUMP option 

.1 STEP option 

..xx xxxx reserved 



1-3 hhhhhh ABEND completion code 

CMP CODE hhhhhhhh 

is the ABEND completion code if 
SVC 13 was called by the ABTERM 
routines. It is the content of 
the TCBCMP field of the current 
TCB at the time the SVC interrupt 
occurred. If ABEND recursion has 
occurred this field will contain 
the recursive completion code. 

SVC m (SPIE) 

Additional field — PICA 

R15 and RO contain no applicable 
information. 

Rl contains the address of the program 
interrupt control area (PICA) . 

PICA hhhhhhhh hhhh 

displays the program interrupt 
control area from the associated 
SPIE macro instruction. 

SVC 15 (ERREXCP) 



RQE TCB hhhhhhhh 

is the address of the TCB 
associated with the I/O request. 

CUU hhhh 

device address in channel-unit 
form of the device associated 
with this I/O request. 



SVC 16 (PURGE) 



Additional fields — DDNAME, DCB, 
PLIST 

R15 and RO contain no applicable 
information. 

Rl address of the purge parameter 
list. 

(n/a I 

DDNAME j cccccccc > 

cccccccc 

is the name of the DD statement 
associated with the requests 
being purged. 

DCB hhhhhhhh 

is the address of the DCB 
associated with the purge 
request. 

PLIST hhhhhhhh hhhhhhhh hhhhhhhh 

displays the PURGE parameter list 
which breaks down as follows: 



Bytes 
hh 



option byte as 
follows: 



Additional fields — DDNAME, RQE, RQE 
TCB, CUU hhhh 

R15 and RO contain no applicable 
information. 



0. 



Purge request 
elements in complete 
DEB chain starting 
with DEB specified in 
address field. 
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1.-. 


• • « • 


Purge the requests 
associated with the 
DEB specified in 
address field. 




.1.. 


.... 


Post the purge 
requests with x'le*. 




..0. 


. . . . 


Allow the active 
request to quiesce. 




..1. 




Halt the I/O 
operations. 




..•0 


.... 


Purge all requests. 




...1 


. . <• ■• 


Purge only related 
requests. 




.... 


.0. . 


Purge AEQ, RB and I OS 
logical channel 
queue. 






.1.. 


Purge AEQ and I OS 
logical channel 
queue. 




* • • a 


..0. 


Purge by DEB 




.... 


..1. 


Purge by TCB 


1-3 


hhhhhh 


address of DEB. 


H 


hh 




completion code 


5-7 


hhhhhh 


address of TCB 


8 


hh 




quiesce indicator: 



Rl contains the address of the 
associated DCB. 

The values, positive or negative, of 
R0 and Rl, indicate the directory 
action STOW is to take as follows: 

R0 Rl Action 

♦ ♦ ADD 

♦ - REPLACE 
♦ DELETE 

CHANGE 

N/A 

DDNAME cccccccc 
******** 

cccccccc is the name of the 
associated DD statement. 



PLIST 



hhhhhhhh 



(2 or 1 words) 



9-13 hhhhhh 



SVC 17 (RESTORE) 



01 if one or more 
requests are 
quiescing. 
address of IOB. 



Additional fields — DDNAME, DCB, DEB 

R15 and R0 contain no applicable 
information. 

Rl contains the address of a pointer 
to the chain of IOBs to be restarted. 

(N/A | 
ccccccccj 
********] 

cccccccc 

is the name of the DD statement 
associated with this IOB. 

DCB hhhhhhhh 

is the address of the DCB 
associated with the IOB. 

DEB hhhhhhhh 

is the address of the DEB 
associated with the IOB. 



SVC 21 (STOW) 



Additional fields — DDNAME, PLIST 

R15 contains no applicable 
information. 

R0 contains the address of the 
parameter list. 



is eight or 16 bytes in length, 
depending on the directory action 
being performed: 

For ADD, REPLACE, or DELETE 
actions the PLIST field is 
eight bytes long and 
contains, the member name or 
alias of the PDS directory 
entry being acted upon. 

For CHANGE the PLIST field 
is 16 bytes long, the first 
eight bytes containing the 
old member name or alias, 
and the second eight bytes 
contain the new member name 
or alias. 

SVC 25 (TRKBAI) 

Additional fields — DDNAME, DCBFDAD, 
DCBTRBAL 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
associated DCB. Note : If Rl is 
negative, the address is in complement 
form and the DCBFDAD and DCBTRBAL 
fields are meaningless. 

!N/A ) 
cccccccc ? 
********) 

is the name of the associated DD 
statement. 

DCBFDAD hhhhhhhh hhhhhhhh 

is the full direct access address 
(MBBCCHHR) from the DCB pointed 
to by Rl. 
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DCBTRBAL hhhh 

is the track balance — the 
number of bytes remaining on the 
current track after a write. The 
field is negative if no bytes 
remain. 

SVC 26 (CATALOG/ INDEX/LOCATE) 

Additional fields — PLIST, DSN 

R15 and RO contain no applicable 
information. 

Rl contains the address of the 
parameter list when CATALOG or INDEX 
issue the SVC call. 

Rl contains the address of CAMLST as 
generated by the CAMLST macro 
instruction when LOCATE issues the SVC 
call. 

DSN cccccccc... 

is the data set name. 



PLIST hhhhhhhh 



{ 4 words) 



is the parameter list passed to 
the SVC routine by the calling 
macro instruction. Its content 
varies, depending on the macro 
instruction issuing the call. 

Entry from CATALOG : 

hh option byte as follows: 



Bytes 




Bits 







Search is to 
start on 
specified 
CVOL 

Search is to 
start on 
SYS. RES 
Catalog a 
data set 
Recatalog a 
data set 
Uncatalog a 
data set 



hh 



option bytes as follows: 



Bits 



2 
3 
U 
5-7 



8 
9-11 



12 
13-15 



00 
00 
00 



Reserved 



hhhhhh address of the area that 
contains the data set 
name 

00 Reserved 

hhhhhh the address of the CVOL 
ID, or zeroed. 



00 



hhhhhh address of the volume 
list 



Entry from INDEX ; 



Bytes 




•X** •*•* 


Build all 
missing index 
levels 


3 


1... 


Delete all 
unneeded 


U 




index levels 


5-7 




except the 






high level 






Indicate 
presence of 
DSCB TIR 





hh 



option byte as follows: 

Bits 

1 Search is to 

start on 

specified 

CVOL 
search is to 

start on 

SYS. RES 



hh 



option byte as follows: 


Bits 






.1.. 


.... 


Build an 
index 


..1. 


.... 


Build a 

generation 

index 


...1 


.... 


Build an alias 


.... 


1... 


Connect CVOLs 


.... 


.1.. 


Delete an 
index 






Delete an 
alias 



hh 



hh 



00 



option byte as follows: 

Bits 

1. Disconnect 

CVOLs 
.1 Indicate 

DELETE option 
.... 1... Indicate 

EMPTY option 

size of generation data 
group 



hhhhhh a. address of the index 
name, 
b. address of an eight 
byte area that 
contains a high-level 
index name. 
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c. address of an area 
that contains an 
alias to be deleted. 



00 



9-11 hhhhhh the address of the area 
that contains the CVOL 
ID, or zeroed. 

12 00 



13-15 hhhhh a. 



b. 



address of an 
eight- byte area that 
contains an alias for 
a high-level index, 
address of a ten-byte 
area that contains 
the 4- byte device 
code of the CVOL to 
be connected followed 
by its 6- byte volume 
serial number. 



Entry from LOCATE : 



Bytes 













hh 


option byte as follows: 






Bits 










1... 




Search is to 
start on 
specified 
CVOL 






0... 


.... 


Search is to 
start on 
SYS. RES 






.... 


..1. 


Read a block 
by TTR. 






..00 


0.0. 


LOCATE a name 



hh option byte as follows: 

Bits 

.000 0000 LOCATE a name 



13-15, hhhhhh address of a 265 byte 
workarea which must be 
on a doubleword 
boundary. If the issuer 
of LOCATE has a non-zero 
protect key, then the 
workarea must have a 
matching storage protect 
key. 

SVC 27 (OBTAIN) 

Additional fields — PLIST, VOLSER, 
DSN/CCHHR 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST hhhhhhhh ... (4 words) 

displays the OBTAIN parameter 
list which breaks down as 
follows: 



Bytes 
0-3 



hhhhhhhh operation code as 
follows : 



4-7 



C1000000 
C1800000 



hhhhhhhh 



8-11 hhhhhhhh 



SEARCH for DSNAME 
SEEK for track 
address 

address of data 
set name or 
address of track 
address of DSCB, 
CCHHR depending 
on operation 
code. 

address of the 
volume serial 
number 



2 hh option byte as follows: 

Bits 

LOCATE a name 

3 00 

4 00 

5-7 hhhhhh address of the data set 
name or the relative 
track address (TTR) of 
the desired block in the 
catalog. 

8 00 

9-11 hhhhhh address of the CVOL ID 
or zeroes. 

12 00 



12-15 hhhhhhhh 



JN/A 
VOLSER {cccccc 



address of 

14-byte 

workarea. 



cccccc is the volume serial 
number of the associated volume. 

N/A indicates that the volser 
pointer in the parameter list was 
zero. 



Innnnn 
DSN/CCHHR cccccccccc 



nnnnn is the track address in 
EBCDIC notation and is displayed 
when the operation code in Word 1 
of the parameter list indicates 
SEEK. 
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cccccc ... is the data set name 
and is displayed when the 
operation code in word 1 of the 
parameter list indicates SEARCH. 
N/A if the name is unavailable. 



SVC 28 (OPENEXT) 



RO contains the address of the UCB for 
the device on which unmounted volumes 
should be mounted, or zero. 



Rl contains the address of the 
parameter list. 



PLIST hhhhhhhh 



(4 words) 



Additional fields — content of R13 

R15 contains no applicable 
information. 

RO contains zeroes, or the DCB address 
of the SYSCTLG to be processed. 

Rl contains the UCB address of the 
volume whose SYSTCLG is to be opened, 
if RO contains zeroes. 



displays the RENAME parameter 
list which breaks-down as 
follows : 

Bytes 

0-3 x , 41002000' 
5-7 hhhhhhhh address of old 
data set name 



8-11 hhhhhhhh 
12-15 hhhhhhhh 



address of new 
address of the 
volume list 



SVC 29 (SCRATCH) 

Additional fields — PLIST, DSN 

R15 contains no applicable 
information. 

RO contains zeroes; or, the address of 
a UCB or a SUBUCB (for a 2321 device) 
for the device upon which unmounted 
volumes may be mounted. 

PLIST hhhhhhhh ... (4 words) 

displays the SCRATCH parameter 
list which breaks- down as 
follows : 



Bytes 

0-3 hhhhhhhh operation code 
as follows: 

41004000 — check 
purge date 
41005000 — 
override purge 
date 



4-7 

8-11 
12-15 



hhhhhhhh address of data 
set name 

not used 

address of the 
volume list 



DSN ccccccccc ... 

is the data set name. N/A if the 
name is unavailable. 

SVC 30 (RENAME) 



Additional fields — PLIST, OLD DSN, 
NEW DSN 

R15 contains no applicable 
information. 



OLD DSN ccccc 

is the fully qualified name of 
the data set to be renamed. N/A 
if the name is unavailable. 

NEW DSN ccccc . . . 

is the new name for the data set 
being renamed. N/A if the name 
is unavailable. 

SVC 32 (ALLOCATE) 

Additional fields — CUU, DSN 

R15 contains no applicable information 

R0 when positive, contains the address 
of the associated job file control 
block; when negative (not 
complemented — high-order bit is set 
on) , contains the address of the 
associated model DSCB. 

Rl contains the address of the UCB 
list. 

CUU ccc 

is the unit address from the UCB 
pointed to by Rl. 

DSN cccccccc . . . 

is the data set name from the DSN 
field of the JFCB or DSCB pointed 
to by R0. N/A if the DSN field 
was blank. 

SVC 33 (IOHALT) 

Additional fields — CUU 

R15 and R0 contain no applicable 
information 

Rl contains the address of the UCB 
associated with the request to be 
halted. 
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CUU hhhh 

is the device address associated 
with the device being halted. 



SVC 41 (IDENTIFY) 

Additional fields — EPNAME 

R15 contains no applicable 
information. 

RO contains the entry point name 
address 

Rl contains the main storage address 
for the entry point name being added. 

EPNAME cccccccc 

is the entry point name being 
added. 

SVC H2 (ATTACH) 

Additional fields — SUPRVLIST, PPLIST 

R15 contains the address of the 
parameter list being passed to the SVC 
routine. 

RO contains no significant 
information. 

Rl contains the address of the 
parameter list being passed to the 
called program, or zero (no parameter 
list being passed) . 

SUPRVLIST hhhhhhhh ... (36 bytes) 
is the parameter list being 
passed to the SVC routine and 
breaksdown as follows: 

Bytes 

hh EP/DE flag byte: 

00 ~ EP or EPLOC 

specified 

80 — DE specified 

1-3 hhhhhh address of the EP 
name or directory 
entry (determined 
by byte 0). 

4 hh hierarchy flag 
(used if option 
chosen) : 

00 — no hierarchy 
specified 

01 — hierarchy 

02 — hierarchy 1 
5-7 hhhhhh address of the 

DCB; or zero. 
8 hh Reserved. 
9-11 hhhhhh address of the ECB 
12 hh GSP flag byte: 

00 — bytes 13-15 

contain subpool 

number 



13-15 hhhhhh 



16 



hh 



17-19 hhhhhh 



20 



hh 



21-23 hhhhhh 

24,25 hhhh 

26 hh 

27 hh 

Bits 
x 

.0.. .. 



01 — bytes 13-15 

contain the 

address of a 

listing of subpool 

numbers . 

a subpool number 

or address of 

subpool list 

(determined by 

byte 12) 

SHSP flag byte: 

00 — bytes 17-19 
contain a subpool 
number 

01 — bytes 17-19 
contain the 
address of a list 
of subpool 
numbers - 

a subpool number 

or address of a 

subpool list 

(determined by 

byte 16) 

Roll- In/Roll-Out 

flag: 

00 — new tasK may 
not be rolled-out 
and cannot invoke 
roll- out. 

01 — new task may 
not be rolled-out 
but can invoke 
roll- out 

02 — new task may 
be rolled- out but 
cannot invoke 
roll- out 

03 — new task may 
be rolled-out and 
can invoke 

roll- out 

address of the 
end-of-task exit 
routine 

dispatching 
priority number 

limit priority 
number 

Key Flags byte as 
follows : 



Reserved 
Propagate the 
JSCB field from 
the originating 
task 

If the origina- 
ting task has a 
protect key of 
0, move the 
specified JSCB 
address into the 
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0. 



• • X « 



..i 



attached TCB; 
otherwise , 
propagate the 
originating 
task's TCBJSCB 
field 

Sub pools 251 and 
252 and the job 
pack queue 
pointer of the 
originating task 
are not given 
to the attached 
task. 

Subpools 251 and 
252 of the job 
pack queue 
pointer are 
given to the 
attached task, 
the attached 
task is to have 
a protect key 
of 0. 

Subpool zero is 
to be shared 
with other 
tasks. 

Subpool zero is 
not to be 
shared 

A save area of 
72 bytes is to 
be obtained for 
the task- 
No save area is 
to be obtained. 
Propagate the 
TCBJSTCB field 
from the 
originating 
task. 

The TCBJSTCB of 
the new task is 
to point to the 
new task. 

The new task is 
to operate in 
problem program 
mode. 

1 The new task is 
to operate in 
supervisor mode. 

the entry point 
name for EP; or 
blank for EPLOC or 
DE specification. 



PPLIST hhhhhhhh hhhhhhhh hhhhhhhh 

. . . (up to 40 bytes) 

is the parameter list being 
passed to the called program and 
consists of a series of four-byte 
entries, each entry having it's 
high-order byte reserved, and an 
address in the low- order three 
bytes. 



SVC a H (CHAP) 



0. 



.1. 



0. 



1. 



28-35 hhhh 



Additional fields — CHAP TCB 

R15 contains no applicable 
information. 

R0 contains a signed value to be added 
to the dispatching priority of the 
specified task. A negative value will 
be in two's-complement form. 

Rl contains the address of an area 
containing the address of the TCB 
whose priority is to be changed; or 
zero. If zero, it indicates that the 
active task's priority is to be 
changed. 

CHAP TCB hhhhhhhh 

is the address of the TCB of the 
active task at the time the SVC 
interrupt occurred. 



SVC 51 (SNAP) 



Additional fields — PLIST, MODN 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
parameter list. 

PLIST: 

The PLIST field when SVC 51 is 
called by the SNAP macro 
instruction is 12 bytes in length 
and breaksdown as follows: 

PLIST hhhhhhhh hhhhhhhh hhhhhhhh 
displays three words of the 
parameter list passed to SVC 
51 by SNAP. 



Bytes 

hh 

1 00 

2 hh 



Bits 



0... 




1... 


. . . 


.1.. 


. . . 


..1. 


... 


...1 


... 


* • • * 


X • • 


• * • • 


.1. 


Section 3: 



ID number to be 
printed in the 
identification 
heading of the dump. 



option flag bytes as 
follows : 



ABEND request 

SNAP request 

TCB address given 

Display all 

supervisor data 

Display trace 

table 

Display nucleus 

Snapshot list is 

given 
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hh 



Bits 
1. .. 



0. 



.1. 



..1. ID given 
...1 Display QCBs 



option flag byte as 
follows: 



.... Save area ( see 

next flags) 
.... Display entire 

save area 
.... Display heading 

only 
.... Display registers 

on entry to ABEND 

or SNAP 
.... Display link pack 

area 
1. . . Display job pack 

area 
.1.. Display PSW on 

entry to ABEND or 

SNAP 
. .1. Display all 

subpools less 

than subpool 128 
. . .x Reserved 



00 



5-7 hhhhhh address of DCB 



00 



9-11 hhhhhh address of the TCB 
specified in the 
SNAP macro 
instruction; or 
zero. If zero, the 
dump is for the 
current task. 

Certain calls for SVC 51 may result in 
a 16 byte PLIST field being recorded. 
If there is a problem in this area 
please contact your FE programming 
representative for programming 
support. 

Jn/a 

MODNl cccccccc 

cccccccc is the name of the 
module calling SVC 51. 

N/A appears if no module name is 
available. 

SVC 54 (DISABLE) 



Additional fields -- DDNAME, DCB, DEB 

R15 and R0 contain no applicable 
information. 

Rl contains the address of the 
associated DCB 



(N/A \ 
DDNAME {cccccccc } 

is the name of the DD statement 
associated with this request. 

DCB hhhhhhhh 

is the address of the associated 
DCB. 

DEB hhhhhhhh 

is the address of the associated 
DEB. 

SVC 62 (DETACH) 

Additional fields — DETACH TCB 

R15 and R0 contain no applicable 
information. 

Rl contains the address of an area 
containing the address of the TCB to 
be detached. 

Note: If Rl contains zero the DETACH 
TCB field is meaningless- 

DETACH TCB hhhhhhhh 

is the address of the TCB to be 
detached. 

SVC 65 (QWAIT) 

Additional fields — R2 r QCB 

R15, R0 and Rl contain no applicable 
information. 

R2 contains the address of the QCB for 
the element being waited on. 

QCB hhhhhhhh hhhhhhhh hhhhhhhh 
is the queue control block 
pointed to by R2 f and breakdown 
as follows: 



Bytes 



hh queue status : 

01 — not on ready 
queue 

02 — not waiting 

03 — waiting 



1-3 



hhhhhh address of first 
element on the 
queue. 

hh priority of the 

queue when linked 
onto the ready 
queue. 

hhhhhh address of the next 
item on the ready 
queue. 

hh reserved. 
9-11 hhhhhh address of the STCB 
for the subtask to 
be activated. 



5-7 



8 
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SVC 66 (BTAM TEST) 

Additional fields — IOBERINF 

R15 and RO contain no applicable 
information, 

Rl contains the address of the I OB 
pointed to when the SVC was issued. 

IOBERINF hhhhhhhh ..- (4 words) 

is the error information field 
used by BTAM error recovery 
routines . 

SVC 67 (QPOST) 

Additional fields — R2, QCB 

R15 and RO contain no applicable 
information. 

Rl contains the address of the element 
being posted. 

R2 contains the address of the QCB to 
which the element is being posted. 

QCB hhhhhhhh hhhhhhhh hhhhhhhh 
is the queue control block 
pointed to by R2 and breaksdown 
as follows: 



Bytes 
hh 



queue status; 

01 — not on Ready 
queue 

02 — not waiting 

03 — waiting 



1-3 hhhhhh address of first 
element on the 
queue. 

4 hh priority of the 

queue when linked 
onto the ready 
queue. 

5-7 hhhhhh address of the next 

7 item on the ready 
queue. 

8 hh reserved. 

9-11 hhhhhh address of the STCB 
for the subtask to 
be activated. 



PLIST hhhhhhhh hhhh ... (up to 12 

bytes) 

displays the parameter list 
pointed to by Rl. The content 
varies according to the macro 
instruction calling the SVC. 

Entry from ASGNBFR : 



Bytes 


1-3 
4-7 



04 request byte, 04 

indicates ASGNBFR 
hhhhhh the DCB address 
hhhhhhhh the address of a 
half-word field 
containing the 
number of bytes of 
buffer to be 
assigned. 



Entry from RLSEBFR : 



Bytes 
hh 



request byte: 

08 indicates 

RLSEBFR 

0C indicates 

RLSEBFR ALL 



1-3 hhhhhh the DCB address 
4-7 hhhhhhhh the address of a 
half-word field 
containing the 
number of bytes of 
buffer to be 
released. 



Entry from BUFINQ ; 



Bytes 


1-3 
4-7 



8-11 



10 



hhhhhh 
hhhhhh 



request byte, 10 
indicates BUFINQ 
the DCB address 
address of the 
table of buffer 
addresses (must be 
on a fullword 
boundary) 
hhhhhhhh the number of 

bytes specified to 
be available for 
the table of 
buffer addresses 



SVC 71 (ASGNBFR/RLSEBFR/BUFINQ) 

Additional fields — DDNAME, PLIST 

R15 and R0 contain no applicable 
information 

Rl contains the address of the 
parameter list. 

DDNAME cccccccc 

is the name of the DD statement 
associated with the DCB specified 
by the macro instruction. 



SVC 75 (Dequeue Routine) 

Additional fields — IQE 

R15 contains no applicable information 

R0 contains the address of the next 
IQE on the IRB active list for the 
attention routine when ATTNINQ has 
specified clear mode; otherwise, 
contains zero. 
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Rl Content: 



Bytes 
hh 



1-3 



is a unit index to 
identify a 
particular 22 60 
display station; or 
00 for a 2250 
station, 
hhhhhh the GACB address 



Bytes 

0-3 hhhhhhhh address of the DCB 

4-7 hhhhhhhh EBCDIC character 

set image ID 
8 hh LOAD MODE 

indicator: 



.0 no fold 

.1 fold 

x.xx xxxx reserved 



N/A 
IQE hhhhhhhh hhhhhhhh hhhhhhhh 

when ATTNINQ specifies clear mode 
this field displays the first 3 
words of the IQE pointed to by 
R0: 



Bytes 

0-3 hhhhhhhh the address of the 
next IQE in the 
chain, or zero 

4-7 hhhhhhhh not meaningful 

8-11 hhhhhhhh the address of the 
hhhhhhhh IRB associated 
with the IQE. 

N/A 
will appear in this field 
whenever the ATTNINQ macro 
instruction did not specify clear 
mode. 



SVC 78 (LSPACE) 



hh 



verification 
indicator: 



10 



...1 .... verify 

...0 .... don't verify 

xxx. xxxx reserved 



hh 






data check 










indicator: 




1. 


.. 


.. 


. . block 




.1 


, . 


. . 


. . unblock 




00 


. . 


. . 


. . as DCB specifies 


. . 


. . 


1. 


. . unfold UCS 


3211 


. . 


. . 


.1 


. . fold UCS 3211 


. .XX 


..xx reserved 





11-14 hhhhhhhh EBCDIC FCB 
image ID 

15 hh FCB parameter 
options : 

1 verify FCB 

1 align 

.xxx xxx. reserved 



Additional fields — CUU 

R15 and Rl contain no applicable 
information 



SVC 82 (DISKANAL) 



Entered from modules: 
IEHDANAL, IEHOGETA, 
IEHDCELL, IEHDLABL, 
IEHDREST, IEHDDUMP 



R0 contains the address of the 
associated UCB 



Additional fields — VOLSER, DA-ADDR, 
PLIST 



CUU hhhh is the unit address 



R15 and R0 contain no applicable 
information 



SVC 81 (SETPRT) 

Additional fields — DDNAME, PLIST 

R15 and R0 contain no applicable 
information 

Rl contains the address of the 
parameter list. 

DDNAME cccccccc 

is the name of the DD statement 
associated with the data set 
being printed. 

PLIST hhhhhhhh .. (four words) 

is four words of the parameter 
list being passed to SVC 81 and 
breaks down as follows: 



Rl contains the address of the 
parameter list. 

VOLSER cccccc 

is the volume serial number 

DA-ADDR N/A 

hhhhhhhh hhhhhhhh 

displays a six or eight byte 
track address or N/A, dependent 
on the options in effect for the 
SVC routine. The breakdown is: 



Option 



DA-ADDR Content 



analyze or format six-byte track 
address 

post UCB eight- byte trac 

address 
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address of 
alternate track 
CCHH 
unlabeled volume 

new volume 



N/A 



eight-byte 
track address 
N/A 



PLIST hhhhhhhh ... (16 bytes maximum) 
is either 8, 12, or 16 bytes of 
the parameter list pointed to by 
Rl. The first four bytes always 
consist of a flag byte, defining 
the function to be performed, and 
a 3-byte UCB address. The fifth, 
ninth, and thirteenth bytes, when 
present, will contain a flag 
indicating the last element 
(4-bytes) in the list. The 
breakdown is as follows: 



Bytes 

hh 



function byte as 
follows: 



8F — new volume 
IF — address of 
alternate track 
CCHH 

00 ~ ANALYZE or 
FORMAT 

08 — POST UCB 
88 — unlabeled 
volume 
1-3 hhhhhh address of UCB 

(function 8F) 

4 80 flag byte — last 

element 
5-7 hhhhhh address of DCB 

(function IF) 

4 80 flag byte — last 

element 
5-7 hhhhhh address of 

alternate track 

CCHH 



(function 00) 



4-70 



9-11 



hhhhhhhh address of 

alternate track 
CCHH 

80 flag byte — last 
element 

hhhhhh address of 

alternate track 
information 



(function 
4-7 



9-11 



08) 



hhhhhhhh address of serial 

number 
80 flag byte — last 

element 
hhhhhh address of VTOC 

address of VTOC 



(function 88) 

4-7 hhhhhhhh address of serial 
number 



8-11 hhhhhhhh address of VTOC 
12 80 flag byte — last 

element 
13-15 hhhhhh address of DEB 



SVC 86 (ATLAS) 



Additional fields — PLIST, CCHHR 



R15 and R0 contain no applicable 
information 

Rl contains the address of the 
parameter list 

PLIST hhhhhhhh hhhhhhhh 

is the parameter list passed to 
SVC 86 and breaks down as 
follows : 



Bytes 
hh 



1.. 



flag byte as 
follows : 



... User's channel 

program can not be 
re-executed. 
. xxx xxxx reserved 

1-3 hhhhhh address of IOB 

4 hh flag byte as 
follows: 

1 IEHATLAS is the 

calling program 

.1 a partial count 

(CCHH only) has 
been passed by 
the calling 
program 

..1 a write special 

CCW is required 
for a track 
overflow record 

. . .1 .... a write 
special 
CCW is not 
required 

.... xxxx reserved 

5-7 hhhhhh address of count 

(CCHHR) or partial 
count (CCHH) field 

CCHHR hhhhhhhhhh 

is the five-byte track address of 
the complete (CCHHR) or partial 
count (CCHH) field passed by the 
calling program. 

Note: If entry to SVC 86 is from 
the IEHATLAS program (byte 4, bit 
in parameter list) this address 
points to the CCHH part of the 
count field. 
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SVC 88 (MOD 88) 

Additional fields — DEB, DSSTAT FLGS, 
DEVMOD 

R15 and RO contain no applicable 
information. 

Rl contains the address of the DCB 
associated with the current task at 
the time the SVC was issued. 

DEB hhhhhhhh 

is the address of the data extent 
block (taken from DCB pointed to 
by Rl) 

DSSTAT hh 

the data set status flags field 
(taken from the DEB) 

DEVMOD hh 

the device modifier field (taken 
from the DEB) 

SVC 89 (EMSERV) 

Additional fields — PLIST, RESMCW 

R15 and RO contain no applicable 
information 

Rl contains the address of the 
parameter list 

PLIST hhhhhhhh 

displays four bytes from the 
parameter list being passed to 
the SVC routine. The breakdown 
is: 



B ytes 
hh 



flag byte: 

CO — enter emulator 

mode 

AO — leave emulator 

mode 



1-3 hhhhhh address of control 
storage lead name 



RESMCW hhhhhhhh hhhhhhhh 

displays dight bytes of the 
RESMCW field from the RMS common 
area. 



SVC 98 (TSO PROTECT) 



Additional fields — PLIST, DSN 

R15 and RO contain no applicable 
information 

Rl contains the address of the 
parameter list 

PLIST hhhhhhhh 

displays the first four bytes of 
the parameter list as follows: 



Byte 




1-3 



01 entry code for the 
add function 

02 entry code for the 
replace function 

03 entry code for the 
delete function 

04 entry code for the 
list function 

hhhhhh varies by function 
as follows: 

000000 — add 

function 

000000 — replace 

function 

000000 — delete 

function 

hhhhhh — 80 byte 

buffer address 



DSN cccccccc . . . 

is the data set name 
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IMDPRDMP OUTPUT COMMENTS - GTF PROCESSING 

The following comments may appear in the 
listing of GTF trace records. 

I/O ERROR ON ddname - CONTINUE 

Explanation : The EDIT function of 
IMDPRDMP is being used to process 
a GTF external trace data set. An 
I/O error was encountered while 
attempting to read the trace data 
set identified by ddname. Fewer 
than three consecutive I/O errors 
have occurred for this data set, 
so EDIT continues processing, 
ignoring the current block that 
caused the I/O error. 

I/O ERROR ON ddname - EDIT PROCESSING 
TERMINATED 

Explanation : The EDIT function of 
IMDPRDMP is being used to process 
a GTF external trace data set. 
Three consecutive I/O errors have 
been encountered while attempting 
to read the trace data set 
identified by ddname. EDIT 
processing terminates. 

ERROR IN GTF BUFFER CHAIN 

Explanation : The EDIT function of 
IMDPRDMP is being used to process 
an internal (dump) trace data set. 
While attempting to locate the GTF 
trace buffers, IMDPRDMP 
encountered one of the following 
errors : 

• A buffer pointer was not on a 
word boundary. 

• A buffer pointer addressed an 
area of main storage that 
could not be extracted from 
the dump for one of the 
following reasons: 

1. The pointer addressed an 
area higher than the 
highest address in the 
dump. 

2. IMDPRDMP encountered an 
I/O error while attempting 
to read the record 
containing the area 
addressed by the pointer. 

3. The block containing the 
addressed area was missing 
from the dump, perhaps 
because the program that 
produced the dump 
encountered an I/O error 
while attempting to write 
the block. EDIT 
processing is terminated. 



ERROR IN GTF BUFFER - CONTINUING WITH 
NEXT BUFFER 



Explanation : The EDIT function of 
IMDPRDMP is being used to process 
an internal (dump) trace data set. 
EDIT has encountered a GTF trace 
record with a length that does not 
lie within the acceptable range of 
4 to 272 bytes. EDIT continues 
processing with the next GTF 
buffer. 



GTF NOT ACTIVE AT TIME OF DUMP 



Explanation : The Edit function of 
IMDPRDMP is being used to process 
an internal (dump) trace data set. 
EDIT has determined that GTF was 
not active at the time that the 
dump was taken. EDIT processing 
is terminated. 



TRACE RECORD LL INVALID, DD ddname BLOCK 
NO xxxyyy - EDIT PROCESSING TERMINATED 

Explanation : The EDIT function of 
IDMPRDMP is being used to process 
a GTF external trace data set. 
EDIT has encountered a GTF trace 
record with a length that does not 
lie within the acceptable range of 
4 to 272 bytes. Ddname identifies 
the GTF external data set being 
processed; xxxyyy identifies the 
number of the block containing the 
faulty record. EDIT processing is 
terminated. 

EDIT TERMINATED UPON USER'S REQUEST 

Explanation : A user exit has 
requested EDIT termination by 
returning to EDIT with a return 
code of 24. 

EXIT DELETED UPON USER'S REQUEST 

Explanation : A user exit has 
requested that it no longer be 
invoked during the current EDIT 
execution. This is the result of 
a user exit routine return code of 
16 or 20. 

GTF OPTIONS IN EFFECT - option 

Explanation : The input trace data 
set was created by GTF with trace 
options in effect as indicated by 
'option'. The Service Aids 
publication describes the options 
available. 
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Appendix A: Debugging With an Operating System Dump 



The first facts you must determine in 
debugging with an operating system dump are 
the cause of the abnormal termination and 
whether it occurred in a system routine or 
a problem program. To aid you in making 
these determinations, ABEND, SNAP, and 
indicative dumps provide two vital pieces 
of information — the completion code and 
the active RB queue. Similar information 
can be obtained from a storage image dump 
or a stand-alone dump by analyzing PSWs and 
re-creating an active RB queue. 

A completion code is printed at the top 
of ABEND, SNAP, and indicative dumps. It 
consists of a system code and a user code. 
The system code is supplied by the control 
program and is printed as a 3 -digit 
hexadecimal number. The user code is the 
code you supplied when you issued your own 
ABEND macro instruction; it is printed as a 
4-digit decimal number. If the dump shows 
a user code, the error is in your program, 
and the completion code should lead you 
directly to the source of error. Normally, 
however, a system code will be listed; this 
indicates that the operating system issued 
the ABEND. Often the system completion 
code gives enough information for you to 
determine the cause of the error. The 
explanations of system completion codes, 
along with a short explanation of the 
action to be taken by the programmer to 
correct the error, are contained in the 
publication IBM System/360 Operating 
System; Messages and Codes , GC28-6631. 



To locate the load module that had 
control at the time the dump was issued, 
find the RB associated with the module. If 
the dump resulted from an ABEND or SNAP 
macro instruction, the third most recent RB 
on the queue represents the load module 
that had control. The most recent and 
second most recent RBs represent the ABDUMP 
and ABEND routines, respectively. Storage 
image dumps and stand-alone dumps contain 
PSW information that can be used to 
identify the load module in control. 



Once you have located the RB or load 
module, look at its name. If it does not 
have a name, it is probably an SVRB for an 
SVC routine, such as one resulting from a 
LINK, ATTACH, XCTL or LOAD macro 
instruction. To find the SVC number, look 
at the last three digits of the resume PSW 
in the previous RB on the queue. If a 
previous RB does not exist, the RB in 
question is an SVRB for a routine invoked 



by an XCTL macro instruction. Register 15 
in the extended save area of the RB gives a 
pointer to a parameter list containing the 
name of the routine that issued the XCTL. 



If the RB does not bear the name of one 
of your load modules, either an RB was 
overlaid or termination occurred during 
execution of a system routine. The first 
three characters of the name identify the 
system components. 



If the RB bears the name of one of your 
load modules, you can be reasonably certain 
that the source of the abnormal termination 
lies in your object code. However, an 
access method routine iray be at fault. 
This possibility arises because your 
program branches to access method routines 
instead of invoking them through a 
supervisor -assisted linkage. Thus, an 
access method routine is not represented on 
the active RB queue. To ascertain whether 
an access method routine was the source of 
the abnormal termination, you must examine 
the resume PSW field in the RB. If the 
last 3 bytes in this field point to a main 
storage address outside your program, check 
the load list to see if an access method 
routine is loaded at that address. If it 
is, you can assume that it, and not your 
program, was the source of abnormal 
termination. 



Abnormal Termination in System Routines : 
By analyzing the RB's name field or the SVC 
number in the previous RB, you can 
determine which system load module 
requested the termination. If the RB has a 
system module name, the first three 
characters tell you the name of the system 
component. The remaining characters in the 
name identify the load module in error. 

Remember, although a system routine had 
control when the dump was taken, a problem 
program error may indirectly have been at 
fault. Such a situation might result from 
an incorrectly specified macro instruction, 
an FQE modified inadvertently, a request 
for too much storage space, a branch to an 
invalid storage address, etc. To determine 
the function of the load module that had 
control, consult Appendix C. With its 
function in mind, the completion code 
together with an examination of the trace 
table may help you to uncover which 
instruction in the problem program 
incorrectly requested a system function. 
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Program Check Interruptions in Problem 
Programs ; If you have determined from the 
completion code or PSWs and evaluation of 
the RB queue that the dump resulted from a 
program check in your problem program, 
examine the status of your program in main 
storage. (If you have received only an 
indicative dump, you must obtain either an 
ABEND/SNAP dump or a stand-alone dump at 
this point. ) Locate your program using 
pointers in the RB. If its entry point 
does not coincide with the lower boundary 
of the program, you can find the lower 
boundary by adding 32(20) to the address of 
the RB (systems with MFT). The RB's size 
field gives the number of doublewords 
occupied by the RB, the program, and 
associated supervisor work areas. 
ABEND/SNAP dumps with MFT have the storage 
boundaries of the problem program 
calculated and printed. 

Next, locate the area within your 
program that was executed immediately prior 
to the dump. To do this, you must examine 
the program check old PSW. Pertinent 
information in this PSW includes: 

Bits 12-15: AMWP bits 

Bits 32,33: Instruction length in 
ha If words. 

Bits 40-63: Instruction address 



A useful item of information in the PSW 
is the P bit of the AMWP bits (bits 12-15). 
If the P bit is on, the PSW was stored 
while the CPU was operating in the problem 
program state. If it is off, the CPU was 
operating in the supervisor state. 



wait or a program loop. If a trace table 
exists, examine it for the events preceding 
the trouble or, if the trace table was made 
ineffectual by a program loop, resubmit the 
job and take a dump at an earlier point in 
the program. 



The remaining causes of a dump are an 
error during either execution of an SVC or 
an I/O interruption. In either case, 
examine the trace table. Entries in the 
table tell you what events occurred leading 
up to termination. From the sequence of 
events, you should be able to determine 
what caused a dump to be taken. From here, 
you can turn to system control blocks and 
save areas to get specific information. 
For example, you can find the sense 
information issued as a result of a unit 
check in the UCB, a list of the open data 
sets from the DEB chain, the CCW list from 
the IOB, the reason for an I/O interrupt in 
the status portion of the CSW, etc. 



Specialized Program Checks 

In addition to the error program checks 
(1-15), other system events cause program 
checks which are normally transparent to 
the user. They could, however, if seen in 
a dump (except ABEND dumps where they do 
not appear, result in some confusion. One 
such event is the monitor call interrupt . 
On 360 CPU's, the monitor call appears as a 
01 (operation) interrupt code in the 
program old PSW. To verify that a 
simulated monitor call occurred, check the 
address in the program old PSW. A monitor 
call occurred if: 



Find the last instruction executed 
before the dump was taken by subtracting 
the instruction length from the instruction 
address. This gives you the address of the 
instruction that caused the termination. 
If the source program was written in a 
higher level language, you must evaluate 
the instructions that precede and follow 
the instruction at fault to determine their 
function. You can then relate the function 
to a statement in the source program. 

Other Interruptions in Problem Programs : 
If the completion code or PSWs and the 
active RB queue indicate a machine check 
interruption, a hardware error has 
occurred. Call your IBM Field Engineering 
representative and show him the dump. 

If an external interruption is 
indicated, with no other type of 
interruption, the dump probably was taken 
by the operator. Check with him to find 
out why the dump was taken at this point. 
The most likely reasons are an unexpected 



1. The address (-4) points to an 
execution instruction ('44'); 

2. The execute is operating on an x'AFOO* 
in low core; 

3. A NOP (x'470*) follows the execute. 

370 CPU's support the real monitor call 
interrupt. The code in the program old PSW 
is a x'40', and the PSW address (-4) points 
directly at an x'AF" instruction. 

On 360 CPU's, the x'AF* opcode is simulated 
as follows: 

1. The first time an x'AF' instruction is 
encountered, an execute instruction is 
substituted for the x'AF*. 

2. The execute is of an instruction in a 
low-core table (Class Mask Table). 

3. If the monitor call should occur, the 
instruction in the Class Mask Table is 
an x'AFOO'; if it should not occur, 
the instruction is a x*0700* (NOP). 
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4. Required class and ID information for 
the monitor call are contained in the 
x'^TO* NOP following the execute. 

On 370 CPU's, the monitor call occurs under 
control of a mask in Control Register 8. 

The Generalized Trace Facility (GTF) is a 
user of the monitor call interrupt. For 
more detailed information, refer to the 
Service Aids Logic PLM . GY28-6721. 



Debugging Procedure Summary 



1. Look at the completion code or PSW 
printouts to find out what type of 
error occurred. Common completion 
codes and causes are explained in 
Appendix C. 

2. Check the name of the load module that 
had control at the time the dump was 
taken by looking at the active RB*s. 

3. If the name identifies a system 
routine, proceed to step 4. If the 
name identifies a problem program and 
the completion code or PSW indicates a 
program check, proceed to step 6. If 
the name identifies a problem program, 
and the completion code or PSW 
indicates other than a program check, 
proceed to step 10. 

4. Find the function of the system 
routine using Appendix D. 

5. If the dump contains a trace table, 
begin at the most recent entry and 



proceed backward to locate the most 
recent SVC entry indicating the 
problem state. From this entry, 
proceed forward in the table, 
examining each entry for an error that 
could have caused the system routine 
to be terminated. 



If the name identifies one of your 
load modules, check the instruction 
address and the load list to see if an 
access method routine last had 
control. If so, return to step 4. 



7. Locate your program in the dump. 

8. Locate the last instruction executed 
before the dump. 

9. Examine the instruction and, if the 
program was written in a high-level 
language, the instructions around it 
for a possible error in object code. 

10. If a machine check interruption is 
indicated, call your IBM Field 
Engineering representative. 

11. If only an external interruption is 
indicated, ask the operator why he 
took the dump. Resubmit the job and 
take a dump at the point where trouble 
first occurred. 

12. Examine the trace table, if one is 
present, for events leading up to the 
termination. Use trace table entries 
and/or information in system control 
blocks and save areas to isolate the 
cause of the error. 
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Appendix B: SVCs 



Register contents at entry to an SVC routine are often helpful in 
finding pointers and control information. The table below lists SVC 
numbers in decimal and hexadecimal, and gives the type, associated macro 
instruction, and significant contents of registers and 1 at entry to 
each SVC routine. 



| Decimal 


Hex. 






r 








| No. 

\- 

| 


No. 






-4- 


Type 


I 


Macro 


EXCP 


| Register 
_ + 




j Register 1 
_+ 

| IOB address 


1 ° 







I 


XDAP 








1 1 


1 




I 


WAIT 


| Event count 




j ECB address 


1 1 


1 




I 


WAITR 


| Event count 




j 2 • s complement of 
|ECB address 


| 1 


1 




I 


PRTOV 








1 2 


2 




I 


POST 


| Completion code 




|ECB address 


1 3 


3 




I 


EXIT 








1 " 


4 




I 


GETMAIN 






| Parameter list address 


1 5 


5 




I 


FREEMAIN 






j Parameter list address 


1 6 


6 




II 


LINK 






j Parameter list address 


1 7 


7 




II 


XCTL 






j Parameter list address 


1 8 


8 




II 


LOAD 


j Address of entry point 
j address 


|DCB address 


1 9 


9 


|I 


r II 


DELETE 


| Address of program name 




| 10 
| 10 


A 
A 




I 
I 


GETMAIN or 
FREEMAIN 
(R Operand) 
FREEPOOL 


j Subpool number (byte 
j Length (bytes 1-3) 


0) 


j Address of area to 
jbe freed 


1 11 


B 


|I 


, III 


TIME 






jTime units code 


1 12 


C 




II 


SYNCH 








1 13 


D 




IV 


ABEND 






j Completion code 


1 1** 


E 


|II, III 


SPIE 






j PICA address 


1 I 5 


F 




I 


ERREXCP 






j Address of request queue 
j element 
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Decimal 
No. 

j. 

16 

17 

18 

18 

19 

20 

21 
22 

23 

24 
25 
26 
26 
26 
27 
28 
29 
30 
31 
32 
33 
34 

35 
35 
36 
37 
37 
38 
39 



U6Xa 

No. 

10 

11 

12 

12 

13 



14. 

15 
16 

17 

18 
19 
1A 
1A 
1A 
IB 
1C 
ID 
IE 
IF 
20 
21 
22 

23 
23 
24 
25 
25 
26 
27 



Type 
III 


Macro 
PURGE 


III 


RESTORE 


II 


BLDL 


II 


FIND 


IV 


OPEN 



IV 

III 

IV 
IV 



Register 



Address of build list 



CLOSE 

STOW 

OPEN TYPE=J 

CLOSE TYPE=T 



III 


DEVTYPE 


III 


TRKBAL 


IV 


CATALOG 


IV 


INDEX 


III 


LOCATE 


III 


OBTAIN 


IV 


CVOL 


IV 


SCRATCH 


IV 


RENAME 


IV 


FEOV 


IV 


ALLOC 


III 


IOHALT 


IV 


MGCR (MAST 




CMD EXCP) 


IV 


WTO 


IV 


WTOR 


IV 


WTL 


II 


SEGLD 


II 


SEGWT 


II 


TTROUTER 


III, IV 


LABEL 



Parameter list address 



UCB address 
UCB address 



Register 1 



IOB chain address 
DCB address 



Address of parameter list 
of DCB addresses 

Address of parameter list 
of DCB addresses 

DCB address 

Address of parameter list 
of DCB addresses 

Address of parameter list 
of DCB addresses 

ddname address 

DCB address 

Parameter list address 

Parameter list address 

Parameter list address 

Parameter list address 



Parameter list address 
Parameter list address 
DCB address 
Address of UCB list 
UCB address 

Message address 
Message address 
Address of message 
Segment name address 
Segment name address 

Parameter list address 

(Part 2 of 5) 
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j Decimal 


|Hex. 












| No. 


j No. 
-4 


| Type 


Macro 


j Register 




j Register 1 j 


| 40 


j 28 


| ill 


EXTRACT 






{Parameter list address | 


1 *»1 


| 29 


|ii, in 


IDENTIFY 


(Entry point name 


address j Entry point address j 


| 42 


| 2A 


|ii, in 


ATTACH 








| 43 


| 2B 


|il, in 


CIRB 


j Entry point addre 




jsize of work area in | 
jdoublewords | 


i 44 


| 2C 


| i 


CHAP 


| ♦ Increase priority 


jTCB address j 


1 *»5 


1 2D 


| II 


OVLYBRCH 


j - Decrease prior 


ity 




| 46 


| 2E 


| I 


TTIMER 






|1: Cancel | 


j 47 


| 2F 


| II 


STIMER 


j Exit address 




|Timer interval address | 


| 48 


| 30 


|i, II 


DEQ 






IQCB address j 


| 49 


1 31 


1 in 


TEST 








| 50 


| 32 












1 51 


j 33 


| IV 


SNAP 






j Parameter list address j 


| 52 


1 34 


| IV 


RESTART 






|DCB address j 


| 53 


| 35 


I hi 


RELEX 


j Key address 




|DCB address j 


| 54 


| 36 


1 n 


DISABLE 








| 55 


1 37 


1 iv 


EOV 


jEOB address 




JDCB address j 


| 56 


| 38 


jl # II 


ENQ 


j QEL address 




|QCB address | 


| 56 


| 38 


II» II 


RESERVE 








1 57 


1 39 


1 III 


FREEDBUF 


j DECB address 




|DCB address j 


| 58 


j 3A 


1 I 


RELBUF 






JDCB address j 


| 58 


| 3A 


1 I 


REQBUF 






|DCB address | 


1 59 


| 3B 


I III 


OLTEP 








| 60 


| 3C 


j III 


STAE 


j Create SCB 
j 4 Cancel SCB 
|8 




(Parameter list address j 


1 61 


| 3D 


1 III 


TTSAV 






(Parameter list address j 


| 62 


| 3E 


! ii 


DETACH 






(TCB address | 


| 63 


| 3F 


I iv 


CHKPT 






|DCB address | 


| 64 


| 40 


1 III 


RDJFCB 






j Address of parameter list j 
(of DCB addresses | 


| 65 


| 41 


1 II 


QWAIT 






(Parameter list address j 


| 66 


| 42 


1 iv 


BTAMTEST 
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| Decimal 


Hex. | 










j No. 

k 

1 67 


No. | 

+- 

43 | 


Type 



II 


Macro 



ENDREADY 


j Register 
— + 


j Register 1 j 
j QPOST j 


| 68 


44 | 


IV 


SYNADAF 


| Same as register on 
| entry to SYNAD 


j Same as register 1 on j 
j entry to SYNAD j 


| 68 


44 | 


IV 


SYNADRLS 






| 69 


45 | 


III 


BSP 




|DCB address | 


| 70 


46 | 


II 


GSERV 




(parameter list address | 


1 71 


47 J 


III 


RLSEBFR 




(Parameter list address j 


1 71 


47 | 


III 


ASGNBFR 




{Parameter list address j 


1 71 


47 | 


III 


BUFINQ 




j Parameter list address j 


| 72 


48 | 


IV 


CHATR 




| Parameter list address j 


1 73 


49 | 


III 


SPAR 




j Parameter list address j 


| 74 


4A | 


III 


DAR 




j Parameter list address | 


1 75 


4B | 


III 


DQUEUE 




j Parameter list address j 


I 76 


4C | 


IV 


IFBSTAT 






j 77 


4D | 


IV 


QTAMTEST 






| 78 


4E | 


III 


WSCAN 






| 79 


4F | 


I 


STATUS 






| 80 


50 | 


III 


IKASVC 






| 81 


51 | 


IV 


SETPRT 






| 82 


52 j 


IV 


DASDR 






| 83 


53 | 


III 


SMFWTM 




j Message address j 


| 84 


54 j 


I 


GRAPHICS 


j UCB address and buffer 
(restart address 




| 85 


55 | 


IV 


DDRSWAP 






| 86 


56 | 


IV 


ATLAS 




(Parameter list address | 


| 87 


57 J 


III 


DOM 


jlf zero 
jlf negative 


(A DOM message I.D. j 
(A pointer to a list of DOMj 
(message I.Ds | 


| 88 


58 | 


III 


MOD 8 8 


| Routine code 


j DCB address j 


| 89 


59 | 


III 


EMSRV 




(Parameter list address j 


| 90 


5A j 


IV 


XQMNGR 


j Address of list of 
| ECB/IOB pointers 
| (optional) 


(QMPA address j 


1 91 


5B | 


III 


VOLSTAT 


j DCB address 


(zero: issued by CLOSE j 
(Non-zero: issued by EOV | 
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j Decimal 
j No. 


1 

Hex. 
No. 


— 


Type 


Macro 


j Register 

. J. _ __ 


T ~ 1 

j Register 1 | 

_„i , , j 


r — 1 

| 92 


r 1 

5C 




— — -I 

I 


TCBEXCP 




t 7 


| 93 


5D 




IV 


TGET/TPUT 


|TJID £ buffer Size 


j Address of User's Buffer j 


| 94 


5E 




IV 


STERMINAL 
STATUS 


| Entry code 




I 95 


5F 




I 


TSEVENT 


JTJID/Entry Code or 


|Not Always Applicable | 


I 96 


60 




III 


STAX 




j Parameter List Address j 


| 97 


61 




III 


TEST-TSO 






| 98 


62 




IV 


PROTECT 




j Parameter List Address j 


| 99 


63 




IV 


none 






| 100 


64 




III 


FIB 






| 101 


65 




I 


QTIP 


j Entry code 


j Parameter List Address j 


| 102 


66 




I 


AQCTL 




j Parameter List Address j 


1 10 3 


67 






XLATE 


j Field length 


| Action byte and field j 
j address j 


| 10 4 


68 




IV 


TOPCTL 


j subroutine indicator 


j Address of operator j 
j control word area j 


| 105 


69 




III 


IMAGLIB 




j Action indication | 


| 109 


6D 




IV 




j — contents used by ca 


lied routine — | 


i 116 


74 




I 


AT 


j — contents used by ca 


lied routines — j 


| 117 

L J 


75 

L_ J 


L_- 


II 




j — contents used by ca 
._x_ 


lied routines — j 
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Appendix C: Completion Codes 



Completion codes issued by operating system 
routines are often caused by problem 
program errors. This appendix includes the 
most common system completion codes, their 
probable causes, and how to correct the 
error or locate related information using a 
dump. For a more comprehensive coverage of 
completion codes, see the publication 
Messages and Codes . 



If a trace table exists (trace option 
was specified at system generation), 
the instruction address in the new 
program check PSW, location 104(68), 
contains the address of a field of 
register contents. This field 
includes registers 10 through 9 on an 
ABEND/SNAP dump, or 10 through 1 on a 
stand-alone dump. 



OCx A program check occurred without a 
recovery routine. If bit 15 of the 
old program PSW (PSW at entry to 
ABEND) is on, the problem program had 
control when the interruption 
occurred; "x" reflects the type of 
error that causes the interruption: 

x Cause 

1 Operation 

2 Privileged operation 

3 Execute 

4 Protection 

5 Addressing 

6 Specification 

7 Data 

8 Fixed-point overflow 

9 Fixed-point divide 
A Decimal overflow 

B Decimal divide 

C Exponent overflow 

D Exponent underflow 

E Significance 

F Floating-point 

The correct register contents are 
reflected under the heading "REGS AT 
ENTRY TO ABEND" in an ABEND/SNAP dump. 
In a stand-alone dump, register 
contents can be found in the register 
save area for ABEND'S SVRB. 

0F1 A program check occurred in the 

interruption handling part of the 
input/output supervisor. The 
applicable program check PSW can be 
found at location 40(28). (In systems 

with MFT, this PSW is valid only if 
the first four digits are 0004) . 

The problem program can be responsible 
for this code if: 

1. An access method routine in the 
problem program storage area has 
been overlaid. 

2. An IOB, DCB, or DEB has been 
modified after an EXCP has been 
issued, but prior to the 
completion of an event. 



0F2 



If no trace table exists, the above 
field contains registers 10 through 1 
on both ABEND/SNAP (MFT only) and 
stand-alone dumps. 



Most frequently caused by incorrect 
parameters passed to a type I SVC 
routine. 



100 A device has been taken off-line 
without informing the system, or a 
device is not operational. 

If a trace table exists, the roost 
current entry is an SIO entry 
beginning with 30. The last 3 digits 
of the first word give the device 
address . 

If a trace table does not exist, 
register 1 (in the SVRB for the ABEND 
routine) contains a pointer to the IOB 
associated with the device. 

101 The wait count, contained in register 
when a WAIT macro instruction was 
issued, is greater than the number of 
ECBs being waited upon. 

102 An invalid ECB address has been given 
in a POST macro instruction. 

If a POST macro instruction has been 
issued by the problem program, the ECB 
address is given in register 1 of 
either the trace table entry or the 
SVRB for the ABEND routine. 

If the POST was issued by an I/O 
interruption handler, the ECB address 
can be found in the IOB associated 
with the event. 

106 During a transient area load or a 

dynamic load resulting from a LINK, 
LOAD, XCTL, or ATTACH macro 
instruction, the fetch routine found 
an error. A description of the error 
is contained in register 15 of ABEND'S 
SVRB register save area: 
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OD The control program found an 
invalid record type. 

OE The control program found an 
invalid address. The problem 
program may contain a relocatable 
expression that specifies a 
location outside the partition 
boundaries. 

OF A permanent I/O error has 

occurred. This error can probably 
be found in the trace table prior 
to the ABEND entry. 

Register 6 of ABEND'S SVRB register 
save area points to the work area used 
by the fetch routine. This area 
contains the IOB, channel program, RLD 
buffer, and the BLDL directory entry 
associated with the program being 
loaded. 

122 The operator cancelled the job and 
requested a dump. 

155 An unauthorized user (a user other 
than dynamic device reconfiguration) 
has issued SVC 85. The user's task 
has been abnormally terminated by 
dynamic device recognition. 

200 The error was detected when an I/O 
operation was requested and the 
storage protection keys of the IOB, 
ECB, and DCB were not the same as the 
key in the DEB. (checked for MVT 
only) 

201 This completion code is identical to 
102, but applies to the WAIT macro 
instruction instead of POST. 

20 2 An invalid RB address was found in an 
ECB. The RB address is placed in the 
ECB when a WAIT macro instruction is 
issued. 

213 The error occurred during execution of 
an OPEN macro instruction for a data 
set on a direct-access device. 
Either : 

1. The data set control block (DSCB) 
could not be found on the direct 
access device. 

2. An uncorrectable input/output 
error occurred in reading or 
writing the data set control 
block. 

Register 4 contains the address of a 
combined work and control block area. 
This address plus x'64' is the address 
of the data set name in the JFCBDSNM 
field of the job file control block 

(JFCB). 



222 The operator cancelled the job without 
requesting a dump. The cancellation 
was probably the result of a wait 
state or loop. 

301 A WAIT macro instruction was issued, 
specifying an ECB which has not been 
posted complete from a previous event. 
Either: 

1. The ECB has been reinitialized by 
the problem program prior to a 
second WAIT on the same ECB, or 

2. The high order bit of the ECB has 
been inadvertently turned on. 

308 The problem program requested the 
loading of a module using an entry 
point given to the control program by 
an IDENTIFY macro instruction. 

Register of LOAD'S SVRB register 
save area contains the address (or its 
complement) of the name of the module 
being loaded. 

400 The control program found an invalid 

IOB, DCB, or DEB. Check the following 
blocks for the indicated information: 

• IOB - a valid DCB address. 



406 



506 



DCB 



a valid DEB address 



• DEB - ID of OF and a valid UCB 
address. 

• UCB - a valid identification of 
FF. 

Note : In systems with MVT, this code 
may appear instead of a 200 code, for 
the reasons given under 200. 

A program has the "only loadable" 
attribute or has an entry point given 
to the control program by an IDENTIFY 
macro instruction. In either case, 
the program was invoked by a LINK, 
XCTL, or ATTACH macro instruction. 

Register 15 of the LINK, XCTL, or 
ATTACH SVRB register save area 
contains the address of the name of 
the program being loaded. 

The error occurred during execution of 
a LINK, XCTL, ATTACH, or LOAD macro 
instruction in an overlay program or 
in a program that was being tested 
using the TESTRAN interpreter. 

The program name can be found as 
follows: 

1. If a LOAD macro instruction was 
issued, register in the trace 
table SVC entry or in the SVRB 
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604 



register save area contains the 
address (or its complement) of 
the program name. 

2. If a LINK, XCTL, or ATTACH was 
issued, register 15 of the 
associated SVRB register save 
area contains the address of a 
pointer to the program name. 



Note : Programs written in an overlay 
structure or using TESTRAN should not 
reside in the SVC library. 

During execution of a GETMAIN macro 
instruction, the control program found 
one of the following; 



1. A free area exceeds the 
boundaries of the main storage 
assigned to the task. This can 
result from a modified FQE. 

2. The A-operand of the macro 
instruction specified an address 
outside the main storage 
boundaries assigned to the task. 

605 During execution of a FREEMAIN macro 
instruction, the control program found 
that part of the area to be freed is 
outside the main storage boundaries 
assigned to the task, possibly 
resulting from a modified FQE. 

Item 1 under the 60 4 completion code 
is also applicable to 605. 

606 During execution of a LINK, XCTL, 
ATTACH, or LOAD macro instruction, a 
conditional GETMAIN request was not 
satisfied because of a lack of 
available main storage for a fetch 
routine work area. Consequently, the 
request was not satisfied. 

The name of the load module can be 
found as described under completion 
code 506. 

60A Results from the same situations 

described under 604 and 605 for R-form 
GETMAIN and FREEMAIN macro 
instructions. 

613 The error occurred during execution of 
an OPEN macro instruction for a data 
set on magnetic tape. An 
uncorrectable input/output error 
occurred in tape positioning or in 
label processing. 

700 A unit check resulted from an SIO 

issued to initiate a sense command. 

The defective device can be determined 
from the SIO trace table entry that 



reflects a unit check in the CSW 
status. 

704 A GETMAIN macro instruction requested 
a list of areas to be allocated. This 
type of request is valid only for 
systems with MVT. 

The applicable SVC can be found in a 
trace table entry or in the PSW at 
entry to ABEND. 

705 Results from the same situations 
described under 704 for FREEMAIN macro 
instructions. 

706 During execution of a LINK, LOAD, 
XCTL, or ATTACH macro instruction, the 
requested load module was found to be 
not executable. 

The name of the module can be found as 
described under the completion code 
506. 



804 The error occurred during execution of 
a GETMAIN macro instruction with a 
mode operand of EU or VU. More main 
storage was requested than was 
available. 



806 The error occurred during execution of 
a LINK, XCTL, ATTACH, or LOAD macro 
instruction. 

An error was detected by the control 
program routing for the BLDL macro 
instruction. This routine is executed 
as a result of these macro 
instructions if the problem program 
names the requested program in an EP 
or EPLOC operand. The contents of 
register 15 indicate the nature of the 
errors 

X*04* The requested program w*s 
not found in the indicated 
source. 

X'OS' An uncorrectable 

input/output error occurred 
when the BLDL control 
program routine attempted to 
search the directory of the 
library indicated as 
containing the requested 
program. 

Register 12 contains the address of 
the BLDL list used by the routine. In 
systems with MFT this address plus 4 
is the location of the 8-byte name of 
the requested program that could not 
be loaded. In systems with MVT, 
registers 2 and 3 contain the name of 
the requested module. 
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80A The error occurred during execution of 
an R-form GETMAIN macro instruction. 
More main storage was requested than 
was available. 



905 The address of the area to be freed 
(given in a FREEMAIN macro 
instruction) is not a multiple of 
eight. The contents of register one 
in either the trace table entry or 
ABEND'S SVRB register save area 
reflect the invalid address. 



B05 



A displacement of nine bytes from the 
list address passed to GETMAIN in 
register 1 contains the subpool 
number. Register 1 can be found in 
either the SVC trace table entry or 
ABEND'S SVRB register save area. 



Results from the same situation 
described under B04 for FREEMAIN macro 
instructions. 



90A Results from the same situations 
described under 905 for R-form 
FREEMAIN macro instructions. 

A05 The error occurred during execution of 
a FREEMAIN macro instruction. The 
area to be freed overlaps an already 
existing free area. This error can 
occur if the address or the size of 
the area to be freed were incorrect or 
modified. 

The contents of registers and 1 in 
either the SVC trace table entry or 
ABEND'S SVRB register save area 
reflect the size and address. 

AOA Results from the same situations 
described under A05 for R-form of 
GETMAIN and FREEMAIN macro 
instructions . 

BO 4 This error occurred during execution 
of a GETMAIN macro instruction. A 
subpool number greater than 127 was 
specified. The problem program is 
restricted to using subpools 0-127. 
This error can occur if the subpool 
number was either incorrectly 
specified or modified. 



BOA Results from the same situations 

described under B04 and BOS for R-form 
of GETMAIN and FREEMAIN macro 
instructions. 

The subpool number can be found in the 
high order bytes of register in 
either the SVC trace table entry or 
ABEND'S SVRB register save area. 

B37 The error occurred at an end of 

volume. The control program found 
that all space on the currently 
mounted volumes was allocated, that 
more space was required, and that no 
volume was available for demounting. 

Either allocate more devices or change 
the program so that a device will be 
free when a volume must be mounted. 

Fnn An SVC instruction contained an 

invalid operand; nn is the hexadecimal 
value of the SVC. 

This error can occur if either an 
invalid instruction was issued by the 
problem program or an operand 
referring to an optional function was 
not included during system generation. 
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Appendix D: System Module Name Prefixes 



All load modules associated with a specific operating system component 
have a common prefix on their module names. This appendix lists the 
module name prefixes and the associated system component (s) . 



Prefix Component 



Prefix Component 



IBC 



Independent utility programs 



IFF Graphic programming support 



IEA Supervisor, I/O supervisor, and 
NIP 

IEB Data set utility programs 

IEC Input/output supervisor 

IEE Master scheduler 

IEF Job scheduler 

IEG TESTRAN 

IEH System utility programs 

IEI Assembler program during system 
generation 

IEJ FORTRAN IV E compiler 

IEK FORTRAN IV H compiler 

IEM PL/I F compiler 

IEP COBOL E compiler 

IEQ COBOL F compiler 

IER Sort/Merge program 

IES Report program generator 

IET Assembler E 

IEU Assembler F 

IEW Linkage editor/overlay 

supervisor/program fetch 

IEX ALGOL compiler 

IEY FORTRAN IV G compiler 

IEZ System Interfaces 

IFB Environment recording routines 

IFC Environment recording and print 
routines 

IFD Online test executive program 



IFG Close, open, and related routines 

IGC Transient SVC routines 

IGE I/O error routines 

IGF Machine check handler program 

IHA System control blocks 

IHB Assembler during expansion of 
supervisor and data management 
macro instructions 

IHC FORTRAN library subroutines 

IHD COBOL library subroutines 

IHE PL/I library subroutines 

IHF PL/I library subroutines 

IHG Update analysis program 

IHI Object program originally coded in 
ALGOL language 

IHJ Checkpoint/restart 

IHL Generalized Trace Facility 

IHK Remote job entry 

UN 7094 emulator program for the 
Model 85 

IIO 7074 emulator program on the 
Models 155 and 165 

IIP 7080 emulator program on the Model 
165 

IIQ 1401/1440/1460 emulator program on 
Models 135, 145, and 155 

IIR 1440/7010 emulator program on 
Models 145 and 155 

IIT 709/7090/7094/7094 II emulator 
program on the Model 165 
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IIU 7074 emulator program on the Model IKF USAS COBOL compiler 

155 

IKA Graphic Job Processor IKJ Time Sharing 

IKD Satellite graphic job processor 

messages ILB USAS COBOL subroutines 
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Appendix E: List of Abbreviations 



ABEND abnormal end- of -task 

APR alternate path retry 

CCW channel command word 

CDE contents directory entry 

CPU central processing unit 

CSW channel status word 

CVT communications vector table 

DAR damage assessment routine 

DCB data control block 

DD data definition 

DDR dynamic device reconfiguration 

DEB data extent block 

DPQE dummy partition queue element 

DQE descriptor queue element 

ECB event control block 

FBQE free block queue element 

FQE free queue element 

FRB finch request block 

GQE gotten subtask area queue element 

IOB input/output block 

IPL initial program loading 

1KB interrupt request block 

LLE load list element 

LPRB loaded program request block 

LRB loaded request block 



MFT multiprogramming with a fixed 
number of tasks 



MVT multiprogramming with a variable 
number of tasks 



NIP nucleus initialization program 

PIB partition information block 

PQE partition queue element 

PRB program request block 

PSA prefixed storage area 

PSW program status word 

QCB queue control block 

QEL queue element 

RB request block 

SCB STAE control block 

SIO start input/output 

SIRB supervisor interrupt request block 

SPQE subpool queue element 

SVC supervisor call 

SVRB supervisor request block 

SYS OUT system output 

TCB task control block 

TIOT task input/output table 

UCB unit control block 

WLE wait list element 

XCTL transfer control 

XL extent list 
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Appendix F: ECB Completion Codes 



r T 1 

I Hexadecimal | | 

j Code j Meaning j 

|. + J 

| 7F000000 | Channel program has terminated without error. (CSW contents can be | 

j J useful.) j 

I I I 

| 41000000 I Channel program has terminated with permanent error. (CSW contents can | 

j j be useful. ) j 

I I I 

| 42000000 | Channel program has terminated because a direct access extent address | 

j j has been violated. (CSW contents do not apply.) j 

I I ! 
| 44000000 | Channel program has been intercepted because of permanent error | 
j | associated with device end of previous request. You may reissue the j 
j | intercepted request. (CSW contents do not apply.) j 

II I 
| 48000000 | Request element for channel program has been made available after it | 
j j has been purged. (CSW contents do not apply.) j 

I I I 

J 4F000000 | Error recovery routines have been entered because of direct access | 

j | error but are unable to read home address of record 0. (CSW contents j 

| | do not apply.) j 

l X . J 
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Appendix G; UCB Sense Bytes 



BYTEO 



' v v N BIT 

DEVICEX^ 





1 


2 


3 


4 


5' 


6 


7 


2400 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


WORD 

CNT 

ZERO 


DATA 

CNVTT 

CHK 


2311, 
2841 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


TRK 

CCND 

CHK 


SEEK 
CHK 


2301,2302 
2303,2314 
2319,2820 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 




INVAL 
ADDR 


2250 


CMD 
REJ 


SHOULD 

NOT 

OCCUR 


BUS 
OUT 


SHOULD 

NOT 

OCCUR 


DATA 
CHK 


SHOULD 

NOT 

OCCUR 


BUFFER 
RUN- 
NING 


SHOULD 

NOT 

OCCUR 


2280 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


ILLGL 
SEG 


2282 


CMD 
REJ 


INT 
REQ 


BUS 

OUT 


EQ 
CHK 


DATA 
CHK 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


ILLGL 
SEGN 


1052, 
2150 


CMD 

REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 




1285 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


NON 
RCVY 


KYBD 
CORR 


1287 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


NON 
RCVY 


KYBD 
CORR 


1288 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


NON 
RCVY 


SHOULD 

NOT 

OCCUR 


2495 


CMD 
REJ 


INT 
REQ 


BUS 

OUT 


EQ 
CHK 


DATA 

CHK 


SHOULD 

NOT 

OCCUR 


POSN 
CHK 


SHOULD 

NOT 

OCCUR 


2540, 
2021 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 




UN- 
USUAL 
CMD 




3505, 
3525 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


NOT 
USED 


ABNOR- 
MAL 
FORMAT 
RESET 


PERMAN- 
ENT ERROR 
(BYPASS 
KEY 


3211 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


BUFFER 
PARITY 
CHK 


LOAD 
CHK 


CH9 


1403, 
1443 


CMD 

REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


/TYPE 
/ BAR 


/type 




CH9 


1442,2596 
2501,2520 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 

CHK 


DATA 
CHK 


OVER- 
RUN 




2671, 
2822 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 






2260 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


2701, 
2702 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


LOST 
DATA 


TIME 
OUT 


1419/1275 
PCU 


CMD 
REJ 


INT 

REQ 


BUS 
OUT 


NOT 
USED 


DATA 
CHK 


OVER- 
RUN 


AUTO 
SELECT 


NOT 
USED 


1419/1275 
SCU 


CMD 
REJ 


INT 

REQ 


BUS 
OUT 

CHK 


NOT 
USED 


NOT 
USED 


LATE 
STKR 
SELECT 


AUTO 
SELECT 


OP 

An 


3330, 
| 3333 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 




3410/3411 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 


WORD 

CNT 

ZERO 


DATA 

CNVTT 

CHK 


2305 


CMD 
REJ 


INT 
REQ 


BUS 
OUT 


EQ 
CHK 


DATA 
CHK 


OVER- 
RUN 




3420/3803 


CMD 

REJ 


INT 
REQ 


BUS 

OUT 


EQ 
CHK 


DATA 

CHK 


OVER- 
RUN 


WORD 

CNT 

ZERO 


DATA 

CNVTT 

CHK 






1 


2 


3 


4 


5 


6 


7 


NOISE 


OO-NON-XSTTU 
01- NOT READY 
IO-ROYBjNORWO 
1t-R0Y»RWDN0 


7 

TRK 


AT 

LOAD 

POINT 


WRT 
STATUS 


FILE 

PROT- 
ECT 


NOT 
CAP- 
ABLE 


DATA 

CHK 

FLD 


TRK 

OVER- 
RUN 


END 

OF 
CYL 


IN- 
VALID 
SEQ 


NO 
REC 
FOUND 


FILE 
PROT 


MISSING 

AM 

MHKR 


OVER- 
FLOW 
INL 


DATA 
CHK IN 
COUNT 


TRK 
OVER- 
RUN 


END 

OF 

CYL 


INVAL 
SEQ 


NO 
REC 
FOUND 


FILE 
PROT 


SERVICE 
OVER- 
RUN 


OVER- 
FLOW 
INL 


LIGHT 

PEN 

DETECT 


END 

ORDER 

SEQ 


CHAR 
MODE 




READ 

COUNT 

CHK 


FILM 
LOW 


RECRDR 
FORCED 
GAP 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


2840 

OUTPUT 

CHK 


2840 

INPUT 

CHK 


GRAPH- 
IC CHK 


READ 

COUNT 
CHK 


FILM 
LOW 


RECRDR 
FORCED 
GAP 


FILM 

MOTION 

LIMIT 


SHOULD 

NOT 

OCCUR 


2840 

OUTPUT 

CHK 


2840 

INPUT 

CHK 


GRAPH- 
IC CHK 




TAPE 
MODE 


LATE 
STKR 
SELECT 


NO 

DOC 

FOUND 


SHOULD 

NOT 

OCCUR 


INVAL 
OP 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


SHOULD 

NOT 

OCCUR 


END 

OF 

PAGE 


NO 

DOC 

FOUND 


SHOULD 

NOT 

OCCUR 


INVAL 
OP 


SHOULD 

NOT 

OCCUR 


should^ 

NOT 
OCCUR 


SHOULD 

NOT 

OCCUR 






PERM- 
ANENT 
ERROR 


AUTO- 
MATIC 
RETRY 


MOTION 
MALFUNC- 
TION 


RETRY 
AFTER 
INT RE0 
COMPLETE 






CMD 
RETRY 


PRINT 
CHK 


PRINT 

QUAL- 
ITY 


LINE 
POS 


FORMS 
CHK 


CMD 
SUP 


MECHAN- 
ICAL 
MOTION 










NOT 
USED 


NOT 

USED 


ooc 

UNDER 
READ 
MEAD 


AMT 

FIELD 

VALID 


PROCESS I ACCT* 
CNTRL cifiri 
FIELD Y 
valid (VALID 


TRANSIT 

FIELD 

VALID 


serial' 

FIELD 
VALID 




PERM 
ERR 


INVLD 

TRK 

FORMAT 


END 

OF 

CYL 


STATE 

VAR 

PRES 


NO 
REC 
FOUND 


FILE 
PROT 


WRITE 
INHIBIT 


OPER- 
ATION 
INL 


NOISE 


TU 

STATUS 

A 


TU 

STATUS 

B 


7 

TRK 

TU 


AT 

LOAD 

POINT 


WRT 
STATUS 


FILE 
PROT- 
ECT 


NOT 
CAP- 
ABLE 


PERM 
ERR 


INVLD 

TRK 

FORMAT 


END 

OF 

CYL 




NO 
REC 
FOUND 


FILE 
PROT 




OPER- 
ATION 
INL 


NOISE 


TU 

STATUS 

A 


TU 

STATUS 

B 


7 

TRK 

TU 


LOAD 
POINT 


WRT 
STATUS 


FILE 
PROT- 
ECT 


NOT 
CAP- 
ABLE 
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"X^^ BIT 

DEVICE\ 





1 


2 


3 


4 


5 


6 


7 


2400 


BITS 0-7 INDICATE A TRACK IS IN ERROR 


6&7INDICATE 
NO ERROR OR 
MULTI -ERROR 


2311, 
2841 


UN- 
SAFE 




SERIAL- 

IZER 

CHK 


TAG 
LINE 
CHK 


ALU 
CHK 


UNSEL 
STATUS 




2301,2302 
2303,2314 
2319,2820 


UN- 
SAFE 


SHIFT 

REG 

CHK 


SKEW 
FAIL 


CTR 

CHK 


COMP 

CHK 






2250 




BUFFER ADDRESS REGISTER 
BIT 15 J BIT 14 j BIT 13 | BIT 12 | BIT 11 | BIT 10 J BIT 9 


2280 


BUFFER ADDRESS REGISTER 
BIT 15 1 BIT 14 j BIT 13 | BIT 12 | BIT 11 | BIT 10 | BIT 9 


2282 


BIT 15 


BIT 14 


BUFFER A 
BIT 13 


DDRESS R 

BIT 12 


EGISTER 
BIT 11 


BIT 10 


BIT? 


3211 


CAR* 
FAILED 
TO 
MOVE 


CARR 

SEQ 

CHK 


CARR 
STOP 
CHK 


PLATEN 
FAILED 
TO ADV 


PLATEN 
FAILED 
TO 
RETRACT 


FORMS 
JAM 


RIBBON 
MO- 
TION 


TRAIN 
OVER- 
LOAD 


3330, 
3333 




COR- 
RECT- 
ABLE 




ENV 
DATA 
PRESENT 




2305 


BUF 

LOG 
FULL 


COR- 
RECT- 
ABLE 








3505, 
3525 


USED FOR DIAGNOSTIC PURPOSES ONLY 


3410/3411 


TRACK IN ERROR 


3420/3803 


TRACK IN ERROR 



BYTE 4 



2400 


ECHO 
ERR 


RES 

TAPE 
UNIT 


READ 

CLOCK 

ERR 


WRITE 

CLOCK 

ERR 


DELAY |SEQ 
CNTR 1 IND 
ERR C 


SEQ 
IND 

B 


SEQ 

IND 
A 


2311, 
2841 




2301,2302 
2303,2314 
2319,2820 


SEQ 
IND 



SEQ 
IND 
1 


SEQ 
IND 
2 


SEQ 
IND 
3 


SEQ 
IND 
4 


SEQ 
IND 
5 


SEQ 
IND 
6 


SEQ 
IND 

7 


3330, 
3333 


PHYSICAL DRIVE IDENTIFICATION 


2305 








3410/3411 
3420/3803 


TAPE 
UNIT 
POS 
CHK 


TAPE 
UNIT 
REJ 


EOT 




DIAG 

TRK 

CHK 


TAPE 
UNIT 
CHK 


SPARE 


ALU 
HARD- 
WARE 
ERROR 


REJ 

TAPE 

UNIT 


TAPE 
INDI- 
CATE 


WRITE 

TGR 

VRC 


MICRO- 
PRO* 
DETECT 
ERROR 


LWR 
ERROR 


TAPE 
UNIT 
CHK 





BYTE 6 



3330,* 
3333 


RE- 
VERSE 


CYL 

HIGH 


DIFFER 
HIGH 


HEAD ADDR 


2305* 


CURRENT HEAD ADDR 


3410/3411 


7 

TRK 

TU 


SHORT 

GAP 

MODE 


DUAL 
DEN- 
SITY 


ALTER- 
NATE 
DENSITY 


TU MODEL 


3420/3803 


7 TRK 


CURRENT 

FAILURE 


DUAL 
DEN- 
SITY 


NRZI 

DEN- 
SITY 


TAPE UNIT MODEL DEFINED 






1 


2 


3 


4 


5 


6 


7 


R/W 
VRC 


LRCR 


SKEW 


CRC 


SKEW 

REQ 

VRC 


0-800 
0-1600 


BKWD 
STATUS 


COM- 
PARE 


READY 


ON 
LINE 


READ 
SAFETY 


WRITE 
SAFETY 




FND 

OF 

CYL 




SEEK 
INCMPL 


LRC 

BIT0 


LRC 
BIT 1 


LRC 
BIT 2 


LRC 

BIT 3 










BUFFER ADDRESS REGISTER 
BITS j BIT 7 j BIT 6 | BIT 5 j BIT 4 | BIT 3 j BIT 2 | BIT 1 


BUFFER ADDRESS REGISTER 
BIT 8 j BIT 7 I BIT 6 | BITS | BIT 4 | BIT 3 | BIT 2 [ BIT 1 


BITS 


BIT 7 


BIT 6 


8UFFER ADDRESS REGISTER 
BIT 5 BIT 4 BIT 3 


BIT 2 


BIT 1 


UCSB 
PARITY 


PLB 
PARITY 


FCB 
PARITY 


COIL 
PROT 

CHK 


HAM- 
MER 
FIRE 


FIELD 
ENG 


USCAR 
SYNC 
CHK 


SEP 

SYNC 

CHK 


RESTART COMMAND 




RESTART COMMAND 




USED FOR DIAGNOSTIC PURPOSES ONLY 




VRC 


MTE/ 
LRCR 


SKEW 


END 
DATA 
CHK/ 
CRCR 


ENV 
CHK 


1SOO 
SPI 

SET IN 
TU 


BKWD 




R/W 
VRC 


MTE/ 
LRCR 


SKEW 


END 
DATA 
CHK/ 
CRC 


VRC 
ENV 
CHK 


1600 
SPI 

SET IN 
TU 


BKWD 


C 

COM- 
PARE 



BYTE 5 



COMMAND IN PROGRESS WHEN OVERFLOW INCOMPLETE OCCURS 
OR 
ZERO 



COMMAND IN PROGRESS WHEN OVERFLOW INCOMPLETE OCCURS 
WRITE = X'05' OR 

READ = X'06' ZERO 



CYLINDER ADDRESS 



CYLINDER ADDRESS 



NEW 
SUB- 
SYSTEM 



NEW 
SUB- 
SYSTEM 



NEW 
SUB- 
SYSTEM 



NEW 
SUB- 
SYSTEM 



WRT 
TAPE 
MARK 
CHK 



WRT 
TAPE 
MARK 
CHK 



PE 
ID 
BURST 



PE 
ID 

BURST 



PARITY 
COM- 
PARE 



START 
READ 
CHK 



TACHO- 
METER 
CHK 



PARTIAL 
RECORD 



FALSE 

END 

MARK 



EXCESSIVE 
POST- 
AMPLE 
ORTM 



RPQ 



BYTE 7 



FORMAT OF REMAINING 
SENSE BYTES (8-23) 


ENCODED ERROR 
MESSAGE 


ENCODED ERROR MESSAGE 


LAMP 

FAILURE 

CHK 


TAPE SOT- 
TOM LEFT 
COLUMN 
CHK 


TAPE BOT-t 
TOM RIOH1 
COLUMN 
CHK 


RESET 
KEY 


DATA 
SECURITY 
ERASE 
CHK 




LAMP 
FAILURE 


TAPE 
SOT TOM 
LEFT 


TAPE 

SOT TOM 
RI6HT 


RESET 
KEY 


DATA 

SECURITT 

ERASE 


ERASE 

HEAD 


AIR 

SEARING 
PRES- 
SURE 


LOAD 

FAILURE 
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BYTE 8 



\. BIT 
DEVtCEV^ 





1 


2 

S 1 -■ 

>•■ *' •- 

-vi-"-.. "; 
s . ' ■ 

for-. 


3 


4 


5 


6 


7 


3410/34)1 


Sill 


WRT 
FEE0- 
THROUGH 
CHK 

FEED 

THRU 


END 

VELOCITY 

CHK 

EARLY 

BEGIN 

RDBK 
CHK 


NO 
READ- 
BACK 
DATA 

EARLY 
END 
RDBK 
CHK 


START 
VELO- 
CITY 
CHK 

SLOW 
BEGIN 
RDBK 
CHK 


f/,'.i'! V'% 

*' ,' '*' 
'■"■■. "\ 

SLOW 
END 
RDBK 
CHK 


MARG- 
INAL 
VELO- 
CITY 

VELO- 
CITY 
RETRY 


3420/3803 


IBG 
DROP 

WHILE 
WRT 



BYTE 10 



3420/3803 




BLK ON 

kecoro 

RO BK 
CHK 



WTM 

NOT 
DETECT 



TACHO- 
METER 
START 
FAIL 



VELO- 
CITY 



BYTE 12 



3420/3803 



B2 BUS 

mmTY 

LSRAOOR 
ERR 



ROS2 

PARITY 

ERR 



XFR/ 
LOW 
IC2 
ERR 



INSTR 
DECODE 



ALU 2 
MICRO- 

prbm 

DETECT 
MRDWR 




BYTE 14 



3420/3803 



CONTROL UNIT 
UNIQUE ID LOW 



BYTE 16 



3420/3803 



TAPE UNIT 
UNIQUE ID 




EC LEVEL OF TAPE UNIT 



BYTE 20 



3420/3803 



TUF 



TUE 



PRIMED FOR DEVICE END 
TU D i TU C I TU B I TU A I TU 9 



TU8 



BYTE 22 



3420/3803 



FRU IDENTIFIERS FOR CONTROL UNIT 



BYTF9 






1 


2 


3 


4 


5 


6 


7 




►'.? '.,, ' » 


+ ' ■ • ** '', i ' t 


4 t ./ 






;."*' t 


W&* ?)>■■■•■ " : -k 
■P-' •'•,"• \ 


^ 


SDR 


VELOCITY 




CNT 


CHGE 
WHILE 
WRTNG 


SDR CNTRS 


»' ' •'■ 


CU 








... .- ..■-..•■ •......; 





Bl BUS 
PAR/LSR 
ADDR 
ERR 


ROSI 
PAR 
ERR 


XFR/ 
LOW 
IC 1 
ERR 


INSTRU- 
CTION 
DECODE 


ALU 1 
MICRO- 
PROM 
DETECT 
HRDWH 


D BUS 

PAR 
ALU 1 




BOC 
ALU 2 



BYTE 13 



CONTROL UNIT 
DFNSITY 



CONTROL UNIT 
UNIQUE ID HIGH 



TAPE UNIT 
UNIQUE ID 



BYTE 17 



TWO 
CHAN- 
NEL SW 
(MIS) 


CONTROL UNIT 

DEVICE 

SWITCH FEATURES 


EC LEVEL OF 
CONTROL UNIT 



BYTE 19 



TU7 



PRIMED FOR DEVICE END 
TU 5 I TU 4 I TU 3 I TU 2 



BYTE 21 



LOAD 

BUTTON 

DEPRESS 


LEFT 
REEL 
TURN- 
ING 


RIGHT 
REEL 
TURN- 
ING 


TAPE 
PRE- 
SENT 


REELS 
LOADED 


LOAD 
REWIND 


LOAD 
COM- 
PLETE 


LOAD 
CHECK 



FRU IDENTIFIERS FOR CONTROL UNIT 
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Appendix H: Service Aids 



In addition to the debugging facilities discussed in this manual, IBM 
provides the following service aid programs to aid you in debugging- A 
complete description of each of these service aids and instructions for 
their use are found in the publication IBM System/360 Operating System 
Service Aids . GC28-6719. 



Program Name 



Functional Description 



IMDSADMP A stand-alone program, assembled with user-selected 

options, that dumps the contents of main storage onto a 
tape or a printer. The program has two versions: 

• A high speed version that dumps the contents of main 
storage to a tape. 

• A low speed version that formats and dumps the 
contents of main storage either to a tape or directly 
to a printer. 

IMDPRDMP A problem program that allows the user to format and print 
IMSADMP output data sets, the SYS1.DUMP data set, the TSO 
dump data set and its associated swap data sets, and 
Generalized Trace Facility output data sets. IMDPRDMP can 
also be used to transfer a system dump from a SYS1.DUMP 
data set on a direct access device to another data set for 
later formatting and printing. 

IMCJQDMP A stand-alone program that reads, formats, and prints 

either the entire operating system data set SYS1.SYSJOBQE, 
or selects and prints information related to a specific 
job in that data set. Because it operates independently 
of the operating system, IMCJQDMP can print the contents 
of the job queue as it appeared at the time of abnormal 
termination. 

IMCOSJQD A problem program that reads, formats, and prints the 

contents of the system job queue data set (SYS1.SYSJ0BQE) . 
Either the entire job queue or information related to a 
specific job may be printed. 

Because the program can be run under OS, it is not 
necessary to re-IPL the operating system as with IMCJQDMP. 

IMBLIST A problem program that produces formatted listings of 
object modules, load modules, module cross references, 
CSECT identification records (IDRs) , and PTFs. 

IMBMDMAP A problem program that produces a map of the system 

nucleus, any load module, the resident reenterable load 
module area of an MFT system, or the link pack area of an 
MVT system. The listing produced by this program shows 
the locations of CSECTS, external references, and entry 
points within a load module. 

IMASPZAP A problem program that can inspect and modify either data 
records or load modules located on a direct access storage 
device. 
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IMAPTFLE A problem program that generates job control language 

(JCL) statements necessary to add a PTF to the Operating 
System in a later step, or applies PTFs to the Operating 
System by dynamically invoking the linkage editor. 

IFCDIPOO A problem program that initializes the SYS1.LOGREC data 



IFCEREPO A problem program that edits, writes, and accumulates 
environment records on the SYS1.L0GREC data set. 
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Appendix J: TCAM Debugging Aids 



In addition to the debugging facilities described in this publication, 
the telecommunications access method provides the following aids to 
debugging s 

• I/O error recording procedures. 

• I/O interrupt trace table (line trace). 

• A dispatcher subtask trace table (STCB trace) . 

• Sequential listings of buffers and message queue data sets. 

Optional formatted listings of the line and STCB traces are available 
with TCAM. These debugging aids are described in the publications IBM 
System/360 Operating System; TCAM Programmer's Guide and Reference 
Manual , GC30-2024, and IBM System/360 Operating System; TCAM 
Serviceability Aids Program Logic Manual , GY30-2027. A discussion of 
the TCAM formatted ABEND dump is given in the publication IBM System/360 
Operating System; TCAM Program Logic Manual , GY30-2029. 
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Appendix K: Control Block Pointers 



This appendix summarizes the contents of the control blocks that are 
most useful in debugging. Control blocks are presented in alphabetical 
order, with displacements in decimal, followed by the hexadecimal 
counterpart in parentheses. Figure 56 illustrates control block 
relationships in the System/360 Operating System. Figure 57 shows 
relationships between storage control elements in a system with MVT. 



CVT - Communications Vector Table 
♦0 Address of TCB control words 
+53(35) Address of entry point of ABTERM 
+19 3 (CI) Address of secondary CVT (used 

only with Model 65 

Multiprocessing systems and TSO) 



RB - Request Block (MVT) 

+4 Last half of user's PSW 

+13 (D) CDE address 

+16(10) Resume PSW 

+29 (ID) Address of previous RB 



DCB - Data Control Block 

+40(28) ddname (before open); offset to 

ddname in TIOT (after open) 
♦45 (2D) DEB address 
+69(45) IOB address 



DEB - Data Extent Block 

+1 

+ 5 

♦25(19) 

♦33(21) 

♦38(26) 

♦42(2A) 



TCB address 

Address of next DEB 

DCB address 

UCB address 

Address of start of extent 

Address of end of extent 



TIOT - Task Input/Output Table 

+0 Job name 

+8 Step name 

+24(18) DD entries begin (one variable- 
length entry for each DD 
statement) 

+0 Length of DD entry 

♦4 ddname 

♦16(10) Device entries begin (one 4-byte 
entry for each device) 

♦20(14) Next device entry (if there is 
one) 



(Next DD entry begins at 24(18) 
plus length of first DD entry) 



ECB - Event Control Block 



♦1 



RB address or completion code 



IOB - Input/Output Block 



-7 

+2 
♦ 5 

♦9 

+17(11) 

♦21(15) 



Address of next IOB (BSAM, QSAM, 
and BPAM) 
Sense bytes 
ECB address 

CSW 

CCW list address 

DCB address 



RB - Request Block (PCP and MFT) 

-8 Address of previous RB on load 

list 
-4 Address of next RB on load list 
+0 Module name 
+13 (D) Entry point address 
+16(10) Resume PSW 
+29 (ID) Address of previous RB 



TCB - Task Control Block (PCP and MFT) 

+1 Address of most recent RB 

+9 Address of most recent DEB 

+13 (D) TIOT address 

+16(10) Completion code 

+25(19) MSS boundary box address 

♦37(25) Address of most recent RB on load 

list 
♦113(71) Address of first save area 
+161 (Al) Address of STAE control block 
+181 (B5) Address of the job step control 

block 



TCB - Task Control Block 
(MFT) with Subtaskinq 

+45 (2D) Address of TCB for job step task 
♦129(81) Address of TCB for next subtask 

attached by same parent task 
+133(85) Address of TCB for parent task 
+137(89) Address of TCB for most recent 

subtask 
+145(91) Address of ECB to be posted at 

task completion 
♦181 (B5) Address of the job step control 

block 
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TCB -■ Task Control Block (MVT) 

♦1 Address of most recent RB 

♦9 Address of roost recent DEB 

♦13(D) TIOT address 

♦16(10) Completion code 

♦25(19) Address of most recent SPQE 

♦33(21) Bit 7 — Non-dispatchability bit 

♦37(25) Address of most recent LLE 

♦113(71) Address of first save area 

♦125 (7D) Address of TCB for job step task 

♦129(81) Address of TCB for next subtask 

attached by same parent task 
♦133(85) Address of TCB for parent task 
♦137(89) Address of TCB for most recent 

subtask 
♦145(91) Address of ECB to be posted at 

task completion 
♦153(99) Address of dummy PQE minus 8 

bytes 
+161 (Al) Address of STAE control block 



♦181 (B5) Address of the job step control 
block 



UCB - Unit Control Block 

-4 CPU ID (used only with Model 65 

Multiprocessing systems) 
♦2 FF (UCB identification) 
♦4 Device address 
♦13(D) Unit name 
♦18(12) Device class 
♦19(13) Device type 
♦22(16) Sense bytes (except devices with 

extended sense) 
♦24(18) Number of sense bytes (devices 

with extended sense) 
♦25(19) Address of sense bytes (devices 

with extended sense) 
♦40(28) Number of outstanding RESERVE 

requests (shared DASD only) 
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Figure 56* Control Block Plow 



Appendix Ks Control Block Pointers 237 



238 Programmer^ Guia e to Debugging (Release 21) 





y 


TCB 







f RB Queue 






25(19) 




♦ Subpool Queu* 






37(25) 




f Load Uit 








Figure 57* MVT Storage Control Flow 
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Appendix L: OPEN/CLOSE/EOV Debugging Aids 



There are two types of traces that may be 
performed during OPEN/CLOSE/EOV processing, 
provided that GTF is active. 

• ABEND trace - A trace performed before 
an OPEN/CLOSE/EOV problem determination 
module calls an ABEND routine. 

• Optional work area trace - A trace 
performed when an OPEN/CLOSE/EOV module 
has finished execution. This trace is 
made only if DCB=DIAGNS=TRACE is 
specified in the DD statement of the 
data set for which the trace is 
desired. 

Further information on requesting these 
traces is contained in I BM System/360 
Operating System: Data Management 
Services . GC26-3746. 

The format of both types of 
OPEN/CLOSE/EOV trace output is as follows: 



FPF 



| USRFF 

l 



FFF CCC 



control block fields 



USRFF 



is the name (excluding the IMD prefix) 
of the IMDPRDMP appendage which 
formats the control block and work 
area information collected by 
OPEN/CLOSE/EOV and included in the GTF 
output data set. FF is the format ID 
for OPEN/CLOSE/EOV. 



ccc 



is the event ID which defines the 
event which caused the trace entry. 
Everything traced by OPEN/CLOSE/EOV 
has an event ID of FF. 



is the control block that was traced 
to provide the problem program with 
OPEN/CLOSE/EOV data for debugging 
purposes . 

When the OPEN/CLOSE/EOV ABEND trace 
occurs, only those control blocks 
meaningful to an ABEND condition will 
be traced. The selection of these 
control blocks is described in IBM 
System/360 Input/Output support 
(OPEN/CLOSE/EOV) PLM . GY28-6609. 

If the optional work area trace has 
been requested, the OPEN/CLOSE/EOV 
work area and the user's DCB will be 
traced after the execution of each 
OPEN/CLOSE/EOV module. 

control block fields 

are the contents of fields in control 
block ccc. For descriptions of the 
fields shown, refer to IBM System/ 360 
Operating System: System Control 
Blocks . GC28-6628 or IBM System/ 3 60 
Operating System: Input/Output 
Support (OPEN/CLOSE/EOV) PLM , 
GY28-6609. 
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Index 



Indexes to systems reference library 
manuals are consolidated in the publication 
IBM System/360 Operating System: Systems 
Reference Library Master Index . GC28-6644. 
For additional information about any 
subject listed below, refer to other 
publications listed for the same subject in 
the Master Index. 

When more than one page reference is 
given, the major reference is first. 



ABEND dumps 

contents of (MVT) 46-64 

contents of (MFT) 29-45 

guide to using (MVT) 63-64 

guide to using (MFT) 44-45 

how to invoke (MVT) 46 

how to invoke (MFT) 29 

introduction to 11 

samples of (MVT) 47-48 

samples of (MFT) 30-31 
Abnormal termination, cause of 

in an ABEND/SNAP dump (MVT) 63 

in an ABEND/SNAP dump (MFT) 44 
Abnormal termination dumps (see ABEND 

dumps) 
Active RB queue 

description of 16 

instructions for using 205 

in a storage dump 141 

in an ABEND/SNAP dump (MVT) 52,63 

in an ABEND/SNAP dump (MFT) 37,44 

in an indicative dump 67 
AMWP bits 

in an indicative dump 67 

meaning of 206 
APSW field, in an ABEND/SNAP dump 

(MVT) 52,63 
ATTACH macro instruction, effects of 18 
Attaching subtasks 20 



Boundary 

problem program 



32 



40,206 



Catalog dump 

CDE r^ 

as used with the load list 17) 

format of 25 

in an ABEND/SNAP dump 54 

in a storage dump 141 
Communications vector table (see CVT) 
Complete dump (MVT) 

description of 46 

sample of 47, 48 
Completion codes 

description of common 215 

explanation of 205 

in an ABEND/SNAP dump (MVT) 

in an ABEND/SNAP dump (MFT) 

in an indicative dump 67 



49 
35 



Console dump facility 68 
COND parameter, 

to regulate job step execution 32 
Contents directory 

description of 17,25 

entries (see CDE) 
Control blocks 

descriptions of 26,27 
| pointers in 233 

relationships between 27 

use in debugging 205 
Control block displays (IMDPRDMP output) 
74-122 

MFT DEB format 103 

MFT job pack queue format 102 

MFT load list format 102 

MFT problem program boundaries 101-102 

MFT RB format 98 

MFT TCB format 92-98 

MFT TIOT format 107 

MVT DEB format 87-90 

MVT job pack queue format 86-87 

MVT load list format 86 

MVT main storage information 85 

MVT RB format 81-85 

MVT TCB format 75-80 

MVT TIOT format 90-92 

TSO PSCB format 121 

TSO RCB format 113 

TSO SWAP DCB format 116 

TSO TAXE format 123 

TSO TJB format 116 

TSO TJBX format 120-121 

TSO TSB format 118 

TSO TSCVT format 108 

TSO UMSM format 116 
Control information 13 
Control program nucleus 

ABEND/SNAP (MVT) 60 

ABEND/SNAP (MFT) 43-44 
CVT 

description of 26 

in a storage image dump 138,139 
| pointers in 233 

Data control! block (see DCB) 

Data event control block 27 

Data extent block (see DEB) 

Damage assessment routine (DAR) 68 

DCB 

description of 27 

in a storage dump 144 
| pointers in 233 
DD statements 

required with ABEND/SNAP dumps 29,32 

sample of SYSABEND 32 
DEB 

description of 27 

in a storage dump 143 

in an ABEND/SNAP dump (MVT) 55 

in an ABEND/SNAP dump (MFT) 41 
| pointers in 233 
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DEB queue 

in a storage dump 143 

in an ABEND/SNAP dump (MVT) 50 

in an ANDED/SNAP dump (MPT) 35 

Debugging procedure 
description of 205 
summary 207 

DELETE macro instruction 16 

Dequeued elements 34 

Descriptor queue element (see DQE) 

Destroyed queues 32 

Device considerations, 
for ABEND/SNAP dumps 29,32 

Dispatcher trace table entry (MVT) 
format of 148,149 
in a SNAP dump 61,64 
in a storage image dump 146 

Dispatching priority 19,20 

DQE 

format of 24 

in a storage dump 143 

in an ABEND/SNAP dump 56, 64 

Dump (see individual type of dump, e.g., 
ABEND, indicative) 

Dump data set 

MVT 46 

MFT 29 
Dump list heading (IMDPRDMP output) 70 
Dynamic area 

in systems with MVT 20 

in systems with MFT 19 



ECB 

completion codes, list of 223 

description of 27 

in a storage dump 145 

pointers in 233 

posting of, using ATTACH 18 
Event control block (see ECB) 
Extent list (see XL) 
External interruption 206 
External trace table entry 

format of 148 

in a SNAP dump 61,63,64 

in a storage dump 148,149 



FBQE 

format of 22-23 

in a storage dump 146 

in an ABEND/SNAP dump 57,64 
FINCH request block 14 
Finding the partition TCB 141 
FRB 14 
Fixed area 

in systems with MFT 19 

in systems with MVT 20 
FQE 

format of (MFT) 21 

format of (MVT) 24 
Free areas 

in an ABEND/SNAP dump (MFT) 44 
Free block queue element (see FBQE) 
Free queue element (see FQE) 



General debugging procedure 
description of 205-207 
summary 207 
General format (IMDPRDMP output) 128 
Generalized trace faility (GTF) 150-203 
comprehensive trace records 
158-166,169-202 
DSP 162 
EXT 163 
10 159 
PCI/IO 159 
PGM 165 
SIO 161 
SSM 166 
SVC 170 
description of 15 
hexadecimal format record 168 
lost event record 167 
minimal trace records 150-157 
DSP 153 
EXT 154 
10 151 
PCI/IO 151 
PGM 155 
SIO 152 
SSM 157 
SVC 156 
SVC comprehensive trace records 169-202 

sub- index 169 
time record 167 
GETMAIN macro instruction 21-22 
Gotten subtask area queue element 21-22 
GQE 21-22 

GTF (see Generalized Trace Facility) 
GTF trace table 

in ABEND/SNAP dumps 150 
in IMDPRDMP output 150 
Guide to using storage image dump 137 



Hardware error 205,206 
Hierarchy, main storage 20-22 



IFCDIP00 230 
IFCEREP0 230 
IMAPTFLE 230 
IMASPZAP 229 
IMBLIST 229 
IMBMDMAP 229 
IMCJQDMP 229 
JMCOSJQD 229 
IMDPRDMP 229 
IMDSADMP 229 
Indicative dumps 

contents of 65-67 

description of 65 

guide to using 67 

introduction 11 
Input/output block (see IOB) 
Interrupt request block 14 
Interruptions 205,206 
IOB 

description of 27 

in a storage dump 144-145 

pointers in 233 
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I/O trace table entry 
format of 148 

in a storage dump (MFT) 148-149 
in a storage dump (MVT) 148 
in a SNAP dump (MVT) 61,63-64 
in an ABEND/SNAP dump (MFT) 42,44 

1KB 14 



Job pack area 14, 17 
Job pack area queue 17 
Job step 19 

Job step task (MVT) 20,46 
JPAQ 17 



LINK macro instruction, effects of 18 

Link pack area (MVT) 20-21 

Link pack area maps (IMDPRDMP output) 

71-73 
LT,y r 

count field 17 

description of 17 

in an ABEND/ SNAP dump (MVT) 50 
Load list 

description of 16 

instruction for using 205,207 

in a storage dump 142 

in an ABEND/SNAP dump (MVT) 53,63 

in an ABEND/SNAP dump (MFT) 38,44 

in an indicative dump 66 

in systems with MVT 17 

in systems with MFT 16-17 
Load list element (see LLE) 
LOAD macro instruction, effects of 18-19 
Load module, storage control for 

in an ABEND/SNAP dump (MVT) 53-54,64 

in systems with MVT 25-26 
Loaded program request block 14 
LPRB 14 
LRB 14 



Main storage hierarchy support 
inclusion of 20-22 
effects on MSS boundary box 21 
effects on partition queue 21 
Main storage layout 

in systems with MFT with subtasking 

19-20 
in systems with MFT without subtasking 

19 
in the systems with MVT 20 
Main storage supervisor's boundary box 

(see MSS) 
Machine check interruption 205-207 
MFT, systems with 

considerations in using an ABEND/SNAP 

dump of 44-45 
contents of an ABEND/SNAP dump of 34-45 
guide to using a storage 

dump of 137 
how to invoke an ABEND/SNAP 

dump of 29 
main storage layout in 20 
storage control in 21-23 
task control characteristics of 19-20 
trace table entries in 148 



Model 65 Multiprocessing system 

trace table formats 149 

prefixed storage area, as shown in an 
ABEND/SNAP dump (MVT) 60 

trace table entries in a SNAP dump 62 
Module name prefixes, list of 219 

description of (MFT) 21-22 

in an ABEND/SNAP dump (MVT) 55-56 

starting address (MFT) 35 
Multiprogramming with a fixed number of 
tasks (see MFT, systems with) 
Multiprogramming with a variable number of 
tasks (see MVT, system with) 
MVT, systems with 

complete ABEND/SNAP dump of 47-48 

contents of an ABEND/SNAP dump 46-64 

guide to using a storage image dump of 
137-146 

guide to using an ABEND/SNAP dump 
of 63-64 

how to invoke an ABEND /SNAP dump of 46 

load list 16 

main storage layout in 20 

storage control in 22-26 

task control characteristics in 20 

trace table entries in 148 



Nucleus 

contents of 19-20 

in an ABEND/SNAP dump (MVT) 

in an ABEND/ SNAP dump (MFT) 



60 
44 



Only loadable (OL) 14 

OPEN/CLOSE/EOV debugging 241 

Output comments (IMDPRDMP output) 130-136 

from GTF processing 203 
Overlaid problem program 34 



Partition (MFT) 19-20 

Partition queue element (see PQE) 

Partition TCBs 138-141 

PIE 35,49 

Pointers, control block 231 

PQE 

format of 23 

in a storage dump 143 

in an ABEND/ SNAP dump 56-64 
PRB 14 

Priority 19-20 

Problem program, how to locate in a 
dump 205-207 
Problem program storage boundaries, in an 

ABEND/SNAP dump (MFT) 40 
Program check interruption 205,206 
Program check old PSW 

in an ABEND/SNAP dump (MVT) 52,63 

information in 205,206 
Program check trace table entry 

format of 148 

in a SNAP dump 61-62 

in a storage dump 145-146 
Program interruption element (see PIE) 
Program request block 14 
Protection key 35 
PSCB 146 
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PSW at entry to ABEND 

in an ABEND/SNAP dump (MVT) 49 
in an ABEND/SNAP dump nMFT) 35 

PSW, program check old (see program check 
old PSW) 

PSW, resume (see resume PSW) 

QCB 57 

Queue control block trace (IMDPRDMP 

output) 70-71 
Queue elements (MVT) 21,22-26 
Queues destroyed 34 



RB 

as affected by LINK, ATTACH, XCTL and 
LOAD 18 

formats of 13-16 

in an ABEND/SNAP dump (MVT) 52-54 

in an ABEND/SNAP dump (MFT) 37,38,44 

in an indicative dump 66 

most recent 35, 49 

name field, in a dump 205 

purpose of 13 
| pointers in 233 

pointers to, in a storage dump 141-142 

queue (see active RB queue) 

sizes of 15 

types of 13-14 

when created 13 

which ones appear in a dump 205 
RCB 145 
Re-creating the task structure 

MFT with subt asking 139 

MVT 139 
Reenterable load module area (MFT) 19 
Region (MVT) 

contents of, in an ABEND/SNAP dump 64 

description of 20 

storage control for 22-24 
Register contents 

in a save area 147 

in an ABEND/SNAP dump (MVT) 60-61 

in an ABEND/SNAP dump (MFT) 43 

in an indicative dump 66 
Request block (see RB) 
Resume PSW 

in an ABEND/SNAP dump (MVT) 53,62 

in an ABEND/SNAP dump (MFT) 38,44 

in an indicative dump 67 
Retain dump 32 
Roll out/ roll in 

effects on partition queue 22-23 



Save areas 

format of 147 

in an ABEND/SNAP dump (MVT) 58 

in an ABEND/ SNAP dump (MFT) 40 
Save area chain 147 
Sense bytes, UCB 

table of 225 
Sequential partitioned system (see MFT, 

systems with) 
Service aids 229 
Set system mask trace table entry 

format of 149 

in an ABEND/SNAP dump 62 



SIO trace table entry 

format of (MFT) 148 

format of (MVT) 148 

in a SNAP dump (MVT) 62-63 

in an ABEND- SNAP dump 
(MFT) 42,44-45 
SIRB 14 
SNAP dumps 

contents of (MVT) 46-63 

contents of (MFT) 32-44 

guide to using (MVT) 63-64 

guide to using (MFT) 44-45 

how to invoke (MVT) 46 

how to invoke 5MFT) 29 

introduction to 11 
Snapshot dumps (see SNAP dumps) 
Space considerations, for ABEND/SNAP 

dumps 32 
SPQE 

format of 24 

in a storage dump 143 

in an ABEND/ SNAP dump 55,64 
SQS (see system queue space) 
SSM (see set system mask trace table entry) 
Storage control 

in systems with MFT with subt as king 22 

in systems with MFT without subtasking 
21 

in systems with MVT 25,26 
Storage dumps 

discussion of 68 

guide to using 137 

introduction to 11 
Sub pool 

definition of 24 

in a storage dump 143 

in an ABEND/SNAP dump 55,64 

queue elements (see SPQE) 
Subtask, as created by ATTACH 18 
Supervisor calls, list of 209 
Supervisor interrupt request block 14 
Supervisor request block 14 
SVC trace table entries 

format of (MFT) 148 

format of (MVT) 148 

in a SNAP dump (MVT) 61-62 

in an ABEND /SNAP dump (MFT) 42-44 
SVCs, list of 209 
SVRB 14 
SYSABEND DD statement 

description of 32 

samples of 33 
SYSOUT, as a dump data set 32 
System control blocks (see control blocks) 
System differences in task control 18-20 
System failure 68 
System queue space (MVT) 20 
System tasks 18-20 
System wait TCB 75 
SYS1.DUMP data set 68,29 
SYSUDUMP DD statement 29 



Task completion code (see completion codes) 

Task control block (see TCB) 

Task control differences, by system 18-20 

Task dispatching priority 20 

Task input/output table (see TIOT) 
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Task management 13-21 

Task supervision 13-21 

Task structure, recreating the, using a 

storage dump (MVT) 139 
Task switch trace table entry (MFT) 

format of 148 

in an ABEND/SNAP dump 44 
Task switching (MFT) 20 
TAXE 146 

TCAM Debugging Aids 231 
TCB 

description of 13 

in an ABEND/SNAP dump (MVT) 49-51 

in an ABEND/ SNAP dump (MFT) 35-37 

information available through 13 

locating, in a storage dump 138-141 
| pointers in 233 

pointers to, in a storage dump (MFT) 
138-139 

queue (MFT) 19,20 

queue (MVT) 20 

relationships 19-20 

summary display (IMDPRDMP output) 
124-127 

MFT without sub task TCBs 125 

MFT or MVT with subtask TCBs 125 
TCBLCT 51,233 
TCBNTC 51, 233 
TCBOTC 51,233 
TCBTCB 50, 233 

Telecommunications Access Method (see TCAM) 
Termination, abnormal (see abnormal 

termination) 
TIOT 

description 26 

in ABEND dump (MVT) 55 

in IMDPRDMP output (MVT) 90 

pointers in 233 
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TJB 146 
TJBX 146 
Traces 147-150 
Trace table 

control block 148 

delimiting entries, in an ABEND/SNAP 
dump (MFT) 44 

description of 148 

format of entries (MFT) 148 

format of entries (MVT) 149 

format of entries 
(Mod 65 multiprocessing systems) 149 

in a SNAP dump (MVT) 61-62 

in a storage dump 148-149 

in an ABEND/SNAP dump (MFT) 

samples of entries 148-149 

usefulness in debugging 206 
TSB 146 
TSCVT 145 
TSO Control Blocks 145-146 



UCB 

description of 27 

in a storage dump 144 

in an ABEND/ SNAP dump (MFT) 

pointers in 234 

UMSM 146 

Unit control block (see UCB) 

Use count 17 



41 



Wait list 17 
Wait list element 
WLE 17 



17,18 



XCTL macro instruction, effects of 
XL 

description of 25 

in a ABEND/SNAP dumps 54,64 
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